Visión general

Se utiliza para enviar mensajes a una instancia de OTSession. La clase OTSession incluye un delegate propiedad. Cuando envías el [OTSession initWithApiKey:sessionId:delegate:] mensaje, se especifica un objeto OTSessionDelegate.

Conectarse a una sesión

– sessionDidConnect: método obligatorio

Se envía cuando el cliente se conecta a la sesión.

- (void)sessionDidConnect:(nonnull OTSession *)session

Parámetros

Declarado en

OTSession.h

– sessionDidDisconnect: método obligatorio

Se envía cuando el cliente se desconecta de la sesión.

- (void)sessionDidDisconnect:(nonnull OTSession *)session

Parámetros

Declarado en

OTSession.h

– session:didFailWithError: método obligatorio

Se envía si falla el intento de conectarse a la sesión o si la conexión a la sesión se interrumpe debido a un error tras haberse establecido correctamente.

- (void)session:(nonnull OTSession *)session didFailWithError:(nonnull OTError *)error

Parámetros

Debate

Este mensaje se envía después de que tu aplicación llame a [OTSession connectWithToken:error:].

Si este mensaje se envía porque la conexión a la sesión se interrumpe tras una conexión correcta, el mensaje se envía justo antes de que [OTSessionDelegate sessionDidDisconnect:] se envía el mensaje.

Declarado en

OTSession.h

Seguimiento de flujos en una sesión

– session:streamCreated: método obligatorio

Se envía cuando se crea una nueva transmisión en esta sesión.

- (void)session:(nonnull OTSession *)session streamCreated:(nonnull OTStream *)stream

Parámetros

Debate

Ten en cuenta que, si tu aplicación publica en esta sesión, tu propio delegado de sesión no recibirá el mensaje [OTSessionDelegate session:streamCreated:] para su propia transmisión publicada. Para ese evento, consulta la llamada de retorno del delegado [OTPublisherKitDelegate publisher:streamCreated:].

Declarado en

OTSession.h

– session:streamDestroyed: método obligatorio

Se envía cuando una transmisión deja de publicarse en la sesión.

- (void)session:(nonnull OTSession *)session streamDestroyed:(nonnull OTStream *)stream

Parámetros

Declarado en

OTSession.h

Supervisión de las conexiones en una sesión

– session:connectionCreated:

Se envía cuando otro cliente se conecta a la sesión. El connection objeto representa la conexión del cliente.

- (void)session:(nonnull OTSession *)session connectionCreated:(nonnull OTConnection *)connection

Parámetros

Debate

Este mensaje no se envía cuando tu propio cliente se conecta a la sesión. En su lugar, el [OTSessionDelegate sessionDidConnect:] El mensaje se envía cuando tu propio cliente se conecta a la sesión.

Declarado en

OTSession.h

– session:connectionDestroyed:

Se envía cuando otro cliente se desconecta de la sesión. El connection El objeto representa la conexión que el cliente tenía con la sesión.

- (void)session:(nonnull OTSession *)session connectionDestroyed:(nonnull OTConnection *)connection

Parámetros

Debate

Este mensaje no se envía cuando tu propio cliente se desconecta de la sesión. En su lugar, el [OTSessionDelegate sessionDidDisconnect:] El mensaje se envía cuando tu propio cliente se conecta a la sesión.

Declarado en

OTSession.h

– session:receivedSignalType:fromConnection:withString:

Se envía cuando se recibe un mensaje en la sesión.

- (void)session:(nonnull OTSession *)session receivedSignalType:(NSString *_Nullable)type fromConnection:(OTConnection *_Nullable)connection withString:(NSString *_Nullable)string

Parámetros

Declarado en

OTSession.h

Supervisión de eventos de archivado

– session:archiveStartedWithId:name:

Se envía cuando comienza la grabación en archivo de una sesión. Si te conectas a una sesión en la que la grabación ya está en marcha, este mensaje se envía en el momento de la conexión.

- (void)session:(nonnull OTSession *)session archiveStartedWithId:(nonnull NSString *)archiveId name:(NSString *_Nullable)name

Parámetros

Debate

En respuesta a este mensaje, quizá te interese añadir una notificación en la interfaz de usuario (como un icono en la vista «Editor») que indique que se está grabando la sesión.

Para obtener más información, consulta OpenTok Visión general del archivado.

Declarado en

OTSession.h

– session:archiveStoppedWithId:

Se envía cuando finaliza la reproducción de una grabación archivada de una sesión.

- (void)session:(nonnull OTSession *)session archiveStoppedWithId:(nonnull NSString *)archiveId

Parámetros

Debate

En respuesta a este mensaje, es posible que desee modificar o eliminar una notificación de la interfaz de usuario (como un icono en la vista «Editor») que indique que se está grabando la sesión.

Para obtener más información, consulta OpenTok Visión general del archivado.

Declarado en

OTSession.h

Volver a conectarse a una sesión

– sessionDidBeginReconnecting:

Se envía cuando el cliente local ha perdido la conexión con una sesión de OpenTok y está intentando volver a conectarse. Esto se debe a una pérdida de conectividad de red. Si el cliente consigue volver a conectarse a la sesión, el [OTSessionDelegate sessionDidReconnect:] se envía el mensaje. De lo contrario, si el cliente no puede volver a conectarse, el [OTSessionDelegate sessionDidDisconnect:] Se envía el mensaje.

- (void)sessionDidBeginReconnecting:(nonnull OTSession *)session

Parámetros

Debate

En respuesta al envío de este mensaje, quizá te interese mostrar una notificación en la interfaz de usuario para informar al usuario de que la aplicación está intentando volver a conectarse a la sesión y de que las transmisiones de audio y vídeo se han desconectado temporalmente.

Declarado en

OTSession.h

– sessionDidReconnect:

Se envía cuando el cliente local se ha vuelto a conectar a la sesión de OpenTok tras haber perdido temporalmente la conexión a la red. Cuando se pierde la conexión, el [OTSessionDelegate sessionDidBeginReconnecting:] El mensaje se envía, antes de el [OTSessionDelegate sessionDidReconnect:] mensaje. Si el cliente no puede volver a conectarse a la sesión, el [OTSessionDelegate sessionDidDisconnect:] se envía el mensaje.

- (void)sessionDidReconnect:(nonnull OTSession *)session

Parámetros

Debate

Los editores y suscriptores existentes se vuelven a conectar automáticamente cuando el cliente se vuelve a conectar y se envía este mensaje.

Por defecto, cualquier señal iniciada por el cliente local mediante el [OTSession signalWithType:string:connection:error:] Se envían las señales del método cuando el cliente se vuelve a conectar. Para evitar que se envíen las señales iniciadas mientras se estaba desconectado, utiliza el [OTSession signalWithType:string:connection:retryAfterReconnect:error:] método para enviar la señal y configurar el retryAfterReconnect parámetro a NO. (Todas las señales enviadas por otros clientes mientras tu cliente estaba desconectado se reciben al volver a conectarse.)

Véase [OTSessionDelegate sessionDidBeginReconnecting:].

Declarado en

OTSession.h

Supervisión de los cambios en el estado de silencio

– session:muteForced:

Se envía cuando un moderador silencia las retransmisiones de la sesión o desactiva el estado de silencio en la sesión.

- (void)session:(nonnull OTSession *)session muteForced:(nonnull OTMuteForcedInfo *)muteForcedInfo

Parámetros

Debate

Véase [OTSession forceMuteAll:error:], [Funcionalidades de OTSession], [OTPublisherKitDelegate muteForced:], y Silenciar el audio de las transmisiones en una sesión.

Declarado en

OTSession.h