OTSubscriberKit

Un OTSubscriberKit El objeto (suscriptor) representa los datos multimedia vinculados a un OTStream. En OTSubscriberKit Esta clase te permite configurar un renderizador de vídeo personalizado para el flujo de vídeo. Utiliza esta clase si te interesa proporcionar tu propia implementación de procesamiento y renderización de vídeo. De lo contrario, utiliza la OTSuscriptor clase, que incluye un procesador de vídeo y un renderizador integrados.

La propiedad «stream» hace referencia al flujo al que te has suscrito. La OTSubscriberKit Esta clase incluye métodos que permiten desactivar y activar la reproducción local de audio y vídeo de la transmisión a la que estás suscrito.

Propiedades

session

Tipo: OTSession *

El OTSession objeto al que pertenece este suscriptor. Una instancia tendrá uno y solo uno OTSession asociada a ella, y esta propiedad es inmutable.

stream

Tipo: OTStream *

La transmisión a la que está vinculado este suscriptor. Cualquier canal multimedia de la transmisión debería poder visualizarse o reproducirse con esta instancia.

delegate

Tipo: id<OTSubscriberKitDelegate>

El OTSubscriberKitDelegate objeto que actúa como delegado y gestiona los eventos básicos de este OTSuscriptor objeto.

Véase también [OTSubscriberKit [audioLevelDelegate], [OTSubscriberKit networkStatsDelegate] y [OTSubscriberKit [rtcStatsReportDelegate].

audioLevelDelegate

Tipo: id<OTSubscriberKitAudioLevelDelegate>

Recibe periódicamente informes sobre los niveles de audio de este abonado.

Se trata de un objeto delegado distinto del establecido como [OTSubscriberKit propiedad [delegate] (la OTSubscriberKitDelegate objeto).

Si no se configura esta propiedad, el subsistema de muestreo de audio queda desactivado.

captionsDelegate

Tipo: id<OTSubscriberKitCaptionsDelegate>

El delegado encargado de recibir los subtítulos de la transmisión de este suscriptor.

subscribeToAudio

Tipo: BOOL

Si se desea suscribirse al audio de la retransmisión.

El valor por defecto es SÍ.

Establecer esta propiedad no tiene ningún efecto si el [OTStream La propiedad [hasAudio] está establecida en NO.

subscribeToVideo

Tipo: BOOL

Si se desea suscribirse al canal de vídeos.

El valor por defecto es SÍ.

Establecer esta propiedad no tiene ningún efecto si el [OTStream La propiedad [hasVideo] está establecida en NO.

subscribeToCaptions

Tipo: BOOL

Si se desea activar los subtítulos.

El valor por defecto es el valor de «captions» del editor de la transmisión [OTStream hasCaptions]

captionsTranslationLanguage

Tipo: NSString *

El idioma de traducción de los subtítulos preferido por este suscriptor.

Esta configuración solo surte efecto cuando los subtítulos están activados. Establece este valor en un código de idioma BCP-47 compatible para recibir subtítulos traducidos, o bien configúralo en nil para desactivar la traducción. El valor por defecto es nil (no hay traducción configurada).

Los códigos de idioma compatibles se definen en la especificación de la API del servidor.

Si el código de idioma no es compatible, el valor no se aplicará. Vuelve a leer esta propiedad tras configurarla para comprobar que el idioma se ha aceptado correctamente.

videoRender

Tipo: id<OTVideoRender>

El motor de renderizado de vídeo de esta instancia.

preferredResolution

Tipo: CGSize

La resolución preferida para la transmisión del suscriptor.

Limitar la resolución y la frecuencia de fotogramas del vídeo (véase [OTSubscriberKit preferredFrameRate]) reduce el uso de la red y de la CPU en el cliente suscrito. Es posible que te interese utilizar una resolución más baja en función de las dimensiones del vídeo del suscriptor en la aplicación. También es posible que te interese utilizar una frecuencia de fotogramas o una resolución más baja para los suscriptores de una transmisión que sea menos importante (y más pequeña) que otras transmisiones.

Este método solo se aplica al suscribirse a una transmisión que utilice el función de vídeo escalable. Hay vídeo escalable disponible:

  • Solo en las sesiones que utilizan el OpenTok Media Router (sesiones con el modo multimedia (configurado en «enrutado»)
  • Solo para transmisiones publicadas por clientes que admitan vídeo escalable (consulta la documentación de función de vídeo escalable).

En las transmisiones que no utilizan vídeo escalable, llamar a este método no tiene ningún efecto.

Nota: La resolución de las transmisiones de vídeo escalables se ajusta automáticamente para cada suscriptor, en función de las condiciones de la red y del uso de la CPU, incluso si no se invoca este método. Invoca este método si deseas limitar la resolución para este suscriptor.

No todas las resoluciones están disponibles para los suscriptores. Cuando estableces la resolución preferida, el SDK de OpenTok para iOS selecciona la mejor resolución disponible que se ajuste a tus limitaciones. Las resoluciones disponibles dependen de la resolución máxima que el editor establezca para la transmisión, que se define como [OTStream Propiedad [videoDimensions] de la transmisión. Cada una de las resoluciones disponibles para una transmisión utilizará la misma relación de aspecto.

preferredFrameRate

Tipo: flotante

La frecuencia de fotogramas preferida para la transmisión del abonado.

Limitar la frecuencia de fotogramas y la resolución del vídeo (véase [OTSubscriberKit preferredResolution]) reduce el uso de la red y de la CPU en el cliente suscrito. Es posible que te interese utilizar una resolución más baja en función de las dimensiones del vídeo del suscriptor en la aplicación. También puede ser conveniente utilizar una frecuencia de fotogramas o una resolución más baja para los suscriptores de una transmisión que sea menos importante (y más pequeña) que otras transmisiones.

Este método solo se aplica al suscribirse a una transmisión que utilice el función de vídeo escalable. Hay vídeo escalable disponible:

  • Solo en las sesiones que utilizan el OpenTok Media Router (sesiones con el modo multimedia (configurado en «enrutado»)
  • Solo para transmisiones publicadas por clientes que admitan vídeo escalable (consulta la documentación de función de vídeo escalable).

En las transmisiones que no utilizan vídeo escalable, llamar a este método no tiene ningún efecto.

Nota: La frecuencia de fotogramas de las transmisiones de vídeo escalables se ajusta automáticamente para cada suscriptor, en función de las condiciones de la red y del uso de la CPU, incluso si no se invoca este método. Invoca este método si deseas limitar la frecuencia de fotogramas para este suscriptor.

Las velocidades de fotogramas disponibles se basan en el valor de la velocidad de fotogramas máxima disponible para la transmisión. Cuando se configura la velocidad de fotogramas preferida para el suscriptor, el SDK de OpenTok para iOS selecciona la mejor velocidad de fotogramas disponible que más se acerque a la preferredFrameRate configuración, en función de las limitaciones de ancho de banda y CPU del cliente.

Las velocidades de fotogramas reales disponibles dependen, de forma dinámica, de los recursos de red y de la CPU de que disponga el editor.

audioVolume

Tipo: doble

El volumen de audio del abonado, entre 0 y 100. Al establecer el valor, si no se encuentra dentro de este intervalo, se ajustará a él.

El valor por defecto es 100.

networkStatsDelegate

Tipo: id<OTSubscriberKitNetworkStatsDelegate>

El OTSubscriberKitNetworkStatsDelegate objeto que recibe periódicamente estadísticas sobre la calidad de los abonados.

A este objeto delegado se le envían mensajes que informan de lo siguiente:

  • Total de paquetes de audio y vídeo perdidos
  • Total de paquetes de audio y vídeo recibidos
  • Total de bytes de audio y vídeo recibidos

Se trata de un objeto delegado distinto del establecido como [OTSubscriberKit propiedad [delegate] (la OTSubscriberKitDelegate objeto).

Véase también [OTSubscriberKit [rtcStatsReportDelegate].

rtcStatsReportDelegate

Tipo: id<OTSubscriberKitRtcStatsReportDelegate>

El OTSubscriberKitRtcStatsReportDelegate que muestra las estadísticas de RTC del abonado. El [OTSubscriberKitRtcStatsReportDelegate El mensaje [suscriptor:rtcStatsReport:] se envía en respuesta a la llamada a [OTSubscriberKit Método [getRtcStatsReport].

Métodos

Nombre Descripción
initWithStream:delegate:(stream, delegate) → {id} Inicializa un suscriptor y lo vincula a un OTStream instancia.
getRtcStatsReport:(error) Obtiene el informe de estadísticas de RTC del suscriptor.
getRtcStatsReport()
init() → {instancetype}

initWithStream:delegate:(stream, delegate) → {id}

Inicializa un suscriptor y lo vincula a un OTStream instancia. Una vez inicializada, la instancia queda vinculada de forma permanente al flujo.

El SDK de OpenTok para iOS admite un número limitado de transmisiones simultáneas de audio y vídeo en una aplicación:

  • En una sesión retransmitida, el límite es de dos flujos. Una aplicación puede tener hasta dos suscriptores, o bien un emisor y un suscriptor.
  • En una sesión enrutada, una aplicación puede admitir simultáneamente un emisor de audio y vídeo, un receptor de audio y vídeo y hasta tres flujos adicionales de solo audio suscritos.

(Para obtener información sobre las sesiones retransmitidas y enrutadas, consulta la documentación sobre el modo multimedia de una sesión.)

Al inicializar un suscriptor, este comienza a transmitir datos desde el servidor de OpenTok, independientemente de si la vista del objeto suscriptor se añade a una supervista.

Puedes reproducir solo el audio (sin suscribirte a la transmisión de vídeo) configurando el [OTSubscriberKit Establecer la propiedad [subscribeToVideo] en NO inmediatamente después de inicializar el OTSuscriptor objeto. Puedes reproducir vídeo únicamente (sin suscribirte a la transmisión de audio) configurando el [OTSubscriberKit Establecer la propiedad [subscribeToAudio] en NO inmediatamente después de inicializar el OTSuscriptor objeto.

Cuando el suscriptor se conecta a la transmisión, el [OTSubscriberKitDelegate Se envía el mensaje [subscriberDidConnectToStream:].

Para un OTSuscriptor objeto, cuando se haya decodificado el primer fotograma del vídeo, el [OTSubscriberDelegate Se envía el mensaje [subscriberVideoDataReceived:].

Si el suscriptor no consigue conectarse a la transmisión, el [OTSubscriberKitDelegate Se envía el mensaje [suscriptor:didFailWithError:].

Parámetros:
Nombre Tipo Descripción
stream OTStream * El OTStream objeto al que vincular esta instancia.
delegate id<OTSubscriberKitDelegate> El delegado (OTSubscriberKitDelegate) que se encargará de gestionar los eventos generados por esta instancia.
Devoluciones:

getRtcStatsReport:(error)

Obtiene el informe de estadísticas de RTC del suscriptor. Se trata de una operación asíncrona. Establece el [OTSubscriberKit propiedad [rtcStatsReportDelegate] e implementar el [OTSubscriberKitRtcStatsReportDelegate suscrito:rtcStatsReport:] antes de llamar a este método. Cuando las estadísticas estén disponibles, la implementación del [OTSubscriberKitRtcStatsReportDelegate Se envía el mensaje [suscriptor:rtcStatsReport:].

Véase también [OTSubscriberKit networkStatsDelegate] y [OTPublisherKit [getRtcStatsReport].

Parámetros:
Nombre Tipo Descripción
error OTError * * Se establece si se produce un error de forma sincrónica durante el procesamiento de la solicitud. El OTSubscriberErrorCode La enumeración (definida en el archivo OTError.h) define los valores para la code propiedad de este objeto. Este objeto es NULL si no se produce ningún error.

getRtcStatsReport()

init() → {instancetype}

Devoluciones: