Tutorial sobre el chat de texto (iOS)

Visión general

La API de señalización de OpenTok permite a los clientes enviar mensajes de texto a otros clientes conectados a la sesión de OpenTok. Puedes enviar un mensaje de señalización a un cliente concreto o enviar un mensaje a todos los clientes conectados a la sesión.

Configuración de tu proyecto

Para seguir este tutorial:

  1. Clonar OpenTok Aplicaciones de ejemplo para iOS repositorio en GitHub:

    git clone https://github.com/opentok/opentok-ios-sdk-samples.git

  2. En la terminal, cd en el subdirectorio «Signaling» del proyecto y, a continuación, ejecuta pod install.

  3. Abre tu proyecto en Xcode haciendo doble clic en el nuevo archivo «Signaling.xcworkspace» que se encuentra en el directorio «Signaling».

  4. Abre el archivo Config.h y configura el SAMPLE_SERVER_BASE_URL cadena a la URL base del servidor que implementa el aprender-opentok-php proyecto. Este servidor proporciona el ID de sesión y los tokens de OpenTok a la aplicación de ejemplo para iOS. Para obtener más información, consulta Configuración del servidor.

Para enviar mensajes de chat de texto entre dos clientes conectados a la sesión de OpenTok, puedes ejecutar la aplicación en el simulador de Xcode y en un dispositivo iOS.

Explorar el código

El ejemplo de archivado se basa en el Ejemplo de «Basic-Video-Chat», y añade las siguientes funciones:

  • Toca el campo de entrada del chat de texto (que dice «Toca aquí para enviar un mensaje de chat»), escribe un mensaje de chat y pulsa el botón «Intro».

    El mensaje de chat de texto se envía a los demás clientes conectados a la sesión de OpenTok. También puedes enviar un mensaje de chat desde los demás clientes al cliente de iOS.

Cuando el usuario introduce texto en el campo de entrada del chat de texto, el [self sendChatMessage:] Se llama al método:

- (void) sendChatMessage
{
    OTError* error = nil;
    [_session signalWithType:@"chat"
                      string:_chatInputTextField.text
                  connection:nil error:&error];
    if (error) {
        NSLog(@"Signal error: %@", error);
    } else {
        NSLog(@"Signal sent: %@", _chatInputTextField.text);
    }
    _chatTextInputView.text = @"";
}

Este método llama a la [OTSession signalWithType:string:connection:] método. Este método envía un mensaje a los clientes conectados a la sesión de OpenTok. Cada señal viene definida por un type una cadena que identifica el tipo de mensaje (en este caso, «chat») y una cadena que contiene el mensaje.

Cuando otro cliente conectado a la sesión envía un mensaje, la implementación de la [OTSessionDelegate session:receivedSignalType:fromConnection:withString:] Se llama al método:

- (void)session:(OTSession*)session receivedSignalType:(NSString*)type fromConnection:(OTConnection*)connection withString:(NSString*)string {
    NSLog(@"Received signal %@", string);
    Boolean fromSelf = NO;
    if ([connection.connectionId isEqualToString:session.connection.connectionId]) {
        fromSelf = YES;
    }
    [self logSignalString:string fromSelf:fromSelf];
}

Este método comprueba si la señal ha sido enviada por el cliente iOS local o por otro cliente conectado a la sesión:

Boolean fromSelf = NO;
if ([connection.connectionId isEqualToString:session.connection.connectionId]) {
    fromSelf = YES;
}

El session El argumento representa el objeto OTSession de tu cliente. El objeto OTSession tiene un connection propiedad con un connectionId propiedad. El connection El argumento representa la conexión del cliente que envía el mensaje. Si coinciden, la señal fue enviada por la aplicación local de iOS.

El método llama a la [self logSignalString:] método que muestra la cadena de mensaje en la vista de texto para los mensajes de chat recibidos.

Esta aplicación utiliza la API de señalización de OpenTok para implementar el chat de texto. No obstante, puedes utilizar la API de señalización para enviar mensajes a otros clientes (de forma individual o colectiva) conectados a la sesión.

¡Enhorabuena! Has completado el tutorial sobre el chat de texto para iOS.
Puedes seguir probando y modificando el código que has creado aquí, o echar un vistazo a la Próximos pasos a continuación. Para obtener más información sobre la señalización, consulta el Guía para desarrolladores de señalización de OpenTok.

Próximos pasos

Cuando hayas terminado aquí, sigue desarrollando y mejorando tu aplicación de OpenTok con estos útiles recursos: