SubscriberKit

java.lang.Object

com.opentok.android.SubscriberKit

Todas las interfaces implementadas: : Observer

Subclases conocidas directas: : Subscriber

clase pública SubscriberKit extende Objeto herramientas Observador

Un objeto SubscriberKit (suscriptor) se encarga de la representación de los datos multimedia vinculados a un Stream. La clase SubscriberKit te permite configurar un renderizador de vídeo personalizado para la transmisión de vídeo. Crea una subclase de SubscriberKit si te interesa proporcionar tu propia implementación de procesamiento y representación de vídeo. De lo contrario, utiliza el Subscriber clase, que incluye un procesador de vídeo y un renderizador integrados.

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

Resumen de clases anidadas

Clases anidadas

Modificador y tipo

Clase

Descripción

static interface

SubscriberKit.AudioLevelListener

Supervisa los cambios en el nivel de audio del abonado.

static interface

SubscriberKit.AudioStatsListener

Define el objeto de escucha para obtener las estadísticas de audio de los suscriptores.

static class

SubscriberKit.Builder

Se utiliza para crear un SubscriberKit objeto.

static interface

SubscriberKit.CaptionsListener

Un detector de cambios en el texto de los subtítulos.

static interface

SubscriberKit.MediaLinkStatsListener

Define el objeto de escucha para obtener estadísticas sobre los enlaces multimedia de los suscriptores, incluidas las métricas a nivel de transporte y los cambios en el estado de la red.

static class

SubscriberKit.SenderStats

Muestra las estadísticas de vídeo facilitadas por el remitente, como las estimaciones de la tasa de bits.

static interface

SubscriberKit.StreamListener

Supervisa cuándo se interrumpe y se reanuda la transmisión del suscriptor.

static class

SubscriberKit.SubscriberAudioStats

Define las estadísticas de audio de un abonado.

static interface

SubscriberKit.SubscriberListener

Supervisa los cambios de estado de un SubscriberKit instancia.

static class

SubscriberKit.SubscriberMediaLinkStats

Proporciona estadísticas sobre los enlaces de los abonados, incluidas métricas de transporte locales y remotas e información sobre la degradación de la red.

static interface

SubscriberKit.SubscriberRtcStatsReportListener

Define el objeto de escucha para obtener los informes de estadísticas de RTC de los suscriptores.

static class

SubscriberKit.SubscriberVideoStats

Define las estadísticas de vídeo de un suscriptor.

static interface

SubscriberKit.VideoListener

Supervisa cuándo el abonado empieza y deja de recibir datos de vídeo.

static interface

SubscriberKit.VideoStatsListener

Define el objeto de escucha para obtener las estadísticas de vídeo de los suscriptores.

Resumen del campo

Campos

Modificador y tipo

Campo

Descripción

protected SubscriberKit.AudioLevelListener

audioLevelListener

protected SubscriberKit.AudioStatsListener

audioStatsListener

protected SubscriberKit.CaptionsListener

captionsListener

protected SubscriberKit.MediaLinkStatsListener

mediaLinkStatsListener

static final String

NETWORK_REASON_NETWORK_CONDITION_CHANGE

Indica que el estado de la red del participante local o remoto ha cambiado.

static final float

NO_PREFERRED_FRAMERATE

Define un valor de reinicio que se pasa a la función setPreferredFrameRate(float preferredFrameRate) método.

static final VideoUtils.Size

NO_PREFERRED_RESOLUTION

Define un valor de reinicio que se pasa a la función setPreferredResolution(VideoUtils.Size preferredResolution) método.

protected BaseVideoRenderer

renderer

protected SubscriberKit.SubscriberRtcStatsReportListener

rtcStatsReportListener

protected Session

session

protected Stream

stream

protected SubscriberKit.StreamListener

streamListener

protected SubscriberKit.SubscriberListener

subscriberListener

static final String

VIDEO_REASON_CODEC_CHANGE

Ha cambiado el códec de vídeo de la transmisión.

static final String

VIDEO_REASON_CODEC_NOT_SUPPORTED

El problema con el vídeo se produjo cuando el vídeo de la transmisión del suscriptor se desactivó porque la transmisión utiliza un códec de vídeo (como H.264) que no es compatible con el dispositivo.

static final String

VIDEO_REASON_INTERRUPTION

La transmisión de vídeo se ha interrumpido.

static final String

VIDEO_REASON_NONE

static final String

VIDEO_REASON_PUBLISH_VIDEO

El evento de vídeo se produjo porque el emisor de la retransmisión inició o detuvo la retransmisión de vídeo.

static final String

VIDEO_REASON_QUALITY

El problema con el vídeo se debió a un cambio en la calidad de la transmisión de vídeo.

static final String

VIDEO_REASON_RESOLUTION_CHANGE

La resolución de la retransmisión ha cambiado.

static final String

VIDEO_REASON_SUBSCRIBE_TO_VIDEO

El incidente del vídeo se debió a una llamada al setSubscribeToVideo(boolean subscribeToVideo) método.

protected SubscriberKit.VideoListener

videoListener

protected SubscriberKit.VideoStatsListener

videoStatsListener

Resumen del constructor

Constructores

Modificador

Constructor

Descripción

protected

SubscriberKit(SubscriberKit.Builder builder)

Resumen del método

Todos los métodosMétodos de instanciaMétodos concretosMétodos obsoletos

Modificador y tipo

Método

Descripción

protected void

attachToSession(Session session)

void

destroy()

En desuso.

protected void

detachFromSession(Session session)

protected void

finalize()

El recolector de basura la invoca en un objeto `SubscriberKit` cuando determina que ya no hay referencias al objeto.

double

getAudioVolume()

Devuelve el volumen de audio del abonado, en un rango comprendido entre 0 y 100.

String

getCaptionsTranslationLanguage()

Obtiene el idioma de traducción de los subtítulos configurado para este suscriptor.

float

getPreferredFrameRate()

Devuelve la frecuencia de fotogramas preferida para la transmisión del suscriptor.

VideoUtils.Size

getPreferredResolution()

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

BaseVideoRenderer

getRenderer()

Devuelve el renderizador de vídeo de este suscriptor.

void

getRtcStatsReport()

Obtiene el informe de estadísticas de RTC del suscriptor.

Session

getSession()

Devuelve el Session que el abonado está obligado a (al llamar al connect() método del objeto Session).

Stream

getStream()

Devuelve el Stream a la que está vinculada esta instancia.

boolean

getSubscribeToAudio()

Independientemente de si el suscriptor está suscrito al contenido de audio o no.

boolean

getSubscribeToCaptions()

Independientemente de si el suscriptor está suscrito a los subtítulos o no.

boolean

getSubscribeToVideo()

Independientemente de si el suscriptor está suscrito al contenido de audio o no.

android.view.View

getView()

Devuelve el objeto `android.view.View` que contiene el vídeo del suscriptor.

protected void

onAudioDisabled()

Se activa cuando se ha desactivado el flujo de audio del suscriptor

protected void

onAudioEnabled()

Se invoca cuando el flujo del suscriptor tiene el audio activado.

protected void

onAudioLevelUpdated(float audioLevel)

protected void

onCaptionText(String text, boolean isFinal)

protected void

onConnected()

Se invoca cuando la instancia se ha conectado correctamente al flujo y comienza a reproducir contenido multimedia.

protected void

onDisconnected()

En desuso.

protected void

onError(OpentokError error)

Se activa cuando un suscriptor no ha podido conectarse al servidor de OpenTok.

void

onPause()

No llames directamente; llama a Session.onPause() en su lugar.

void

onResume()

No llames directamente; llama a Session.onResume() en su lugar.

protected void

onRtcStatsReport(String jsonArrayOfReports)

Se invoca cuando el informe de estadísticas RTC del abonado está disponible en respuesta a una llamada a getRtcStatsReport().

protected void

onStreamDisconnected()

Se invoca cuando se ha interrumpido la transmisión del suscriptor.

protected void

onStreamReconnected()

Se invoca cuando se ha reanudado la transmisión del suscriptor, tras el onStreamDisconnected() se llama al método.

protected void

onVideoDataReceived()

Se invoca cuando un suscriptor recibe datos de vídeo por primera vez.

protected void

onVideoDisabled(String reason)

Se activa cuando el abonado deja de recibir vídeo.

protected void

onVideoDisableWarning()

Se invoca cuando el OpenTok Media Router detecta que la calidad de la transmisión se ha deteriorado y que el vídeo se desactivará si la calidad sigue empeorando.

protected void

onVideoDisableWarningLifted()

Se invoca cuando el OpenTok Media Router determina que la calidad de la transmisión ha mejorado hasta el punto de que la desactivación del vídeo no supone un riesgo inmediato.

protected void

onVideoEnabled(String reason)

Se invoca cuando se inicia la transmisión de vídeo del suscriptor (cuando antes no había vídeo) o cuando se reanuda (tras haber desactivado el vídeo).

void

setAudioLevelListener(SubscriberKit.AudioLevelListener listener)

Asigna un SubscriberKit.AudioLevelListener a esta instancia de SubscriberKit para supervisar las actualizaciones del nivel de audio.

void

setAudioStatsListener(SubscriberKit.AudioStatsListener listener)

Configura un oyente para las estadísticas de audio de los suscriptores.

void

setAudioVolume(double volume)

Establece el volumen de audio del abonado, entre 0 y 100.

void

setCaptionsListener(SubscriberKit.CaptionsListener listener)

Asigna un SubscriberKit.CaptionsListener a esta instancia de SubscriberKit para recibir subtítulos.

void

setCaptionsTranslationLanguage(String language)

Establece el idioma preferido para la traducción de los subtítulos de este suscriptor.

void

setMediaLinkStatsListener(SubscriberKit.MediaLinkStatsListener listener)

Configura un oyente para las estadísticas de enlaces multimedia de los suscriptores.

void

setPreferredFrameRate(float preferredFrameRate)

Establece la frecuencia de fotogramas preferida para la transmisión del suscriptor.

void

setPreferredResolution(VideoUtils.Size preferredResolution)

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

void

setRenderer(BaseVideoRenderer renderer)

En desuso.

void

setRtcStatsReportListener(SubscriberKit.SubscriberRtcStatsReportListener listener)

Establece el oyente del informe de estadísticas de RTC para el suscriptor.

void

setStreamListener(SubscriberKit.StreamListener listener)

Configura un oyente para los eventos relacionados con la interrupción y la reanudación del flujo del suscriptor.

void

setStyle(String key, String value)

Establece un estilo utilizado por este suscriptor.

void

setSubscriberListener(SubscriberKit.SubscriberListener listener)

Establece un SubscriberKit.SubscriberListener objeto para supervisar los cambios de estado.

void

setSubscribeToAudio(boolean subscribeToAudio)

Si se desea suscribirse al audio del canal (true) o no (false).

void

setSubscribeToCaptions(boolean subscribeToCaptions)

Si quieres suscribirte a los subtítulos de la retransmisión (true) o no (false)..

void

setSubscribeToVideo(boolean subscribeToVideo)

Si quieres suscribirte al canal de vídeos (true) o no (false).

void

setVideoListener(SubscriberKit.VideoListener listener)

Establece un SubscriberKit.VideoListener objeto para supervisar cuándo el suscriptor empieza y deja de recibir vídeo.

void

setVideoStatsListener(SubscriberKit.VideoStatsListener listener)

Configura un oyente para las estadísticas de vídeo de los suscriptores.

void

update(Observable o, Object arg)

En desuso.

Métodos heredados de la clase java.lang.Objeto

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Detalles del campo

VÍDEO_MOTIVO_NINGUNO

public static final Cadena VÍDEO_MOTIVO_NINGUNO

Véase también: : - [Valores de campo constantes]

VÍDEO_MOTIVO_PUBLICACIÓN_VÍDEO

public static final Cadena VÍDEO_MOTIVO_PUBLICACIÓN_VÍDEO

El evento de vídeo se produjo porque el editor de la transmisión inició o detuvo la transmisión de vídeo. Esta cadena es el valor de la propiedad «reason» del

Véase también: : - method. - method. - [Valores de campo constantes]

VÍDEO_MOTIVO_PARA_SUSCRIBIRSE_AL_VÍDEO

public static final Cadena VÍDEO_MOTIVO_PARA_SUSCRIBIRSE_AL_VÍDEO

El incidente del vídeo se debió a una llamada al setSubscribeToVideo(boolean subscribeToVideo) método.

Véase también: : - SubscriberKit.VideoListener.onVideoDisabled(SubscriberKit, String) - SubscriberKit.VideoListener.onVideoEnabled(SubscriberKit, String) - [Valores de campo constantes]

VÍDEO_MOTIVO_CALIDAD

public static final Cadena VÍDEO_MOTIVO_CALIDAD

El problema con el vídeo se debió a un cambio en la calidad de la transmisión. La calidad de la transmisión puede variar en función de las condiciones de la red o del uso de la CPU, tanto por parte del suscriptor como del emisor.

Cuando está activada, la función de recambio de audio genera un evento cuando el suscriptor pierde la transmisión de vídeo debido a una disminución de la calidad de la imagen, lo que da lugar a que SubscriberKit.VideoListener.onVideoDisabled(SubscriberKit, String) método que se está llamando. Cuando las condiciones mejoren, la transmisión de vídeo se reanudará, y el SubscriberKit.VideoListener.onVideoEnabled(SubscriberKit, String) se invoca el método.

Cuando se interrumpe la transmisión de vídeo, el suscriptor sigue recibiendo la transmisión de audio, si la hay.

En las sesiones enrutadas, el origen de este evento puede ser el Vonage Video Media Router (recaída de audio del suscriptor) o el cliente emisor (recaída de audio del emisor). Cuando el origen es el cliente emisor, el evento va seguido de un Session.StreamPropertiesListener.onStreamHasVideoChanged(Session, Stream, boolean) función de devolución de llamada enviada por el objeto de sesión, que indica que el canal de vídeo al que se está suscrito ya no está activo. En general, este evento adicional indica un deterioro de la red por parte del editor; sin embargo, las métricas comunicadas por el suscriptor pueden influir en las decisiones de recambio del editor, lo que puede complicar la determinación del origen exacto del deterioro.

En las sesiones retransmitidas, el evento «quality» se activa exclusivamente debido a la lógica interna de recambio de audio del editor (Publisher Audio Fallback). A este evento no le sigue ninguna llamada de retorno que indique que el vídeo está inactivo, ya que es posible que otros suscriptores con mejores condiciones de red sigan recibiendo la transmisión. Tenga en cuenta que, en las sesiones retransmitidas, aunque los eventos de recambio de audio se originan en el emisor, la degradación de la red puede producirse tanto en el lado del emisor como en el del suscriptor.

Véase también: : - method. - method. - [Valores de campo constantes]

VIDEO_MOTIVO_CÓDEC_NO_COMPATIBLE

public static final Cadena VIDEO_MOTIVO_CÓDEC_NO_COMPATIBLE

Véase también: : - [Valores de campo constantes]

VÍDEO_MOTIVO_DE_LA_INTERRUPCIÓN

public static final Cadena VÍDEO_MOTIVO_DE_LA_INTERRUPCIÓN

La transmisión de vídeo se ha interrumpido.

Véase también: : - [Valores de campo constantes]

VÍDEO_MOTIVO_CAMBIO DE RESOLUCIÓN

public static final Cadena VÍDEO_MOTIVO_CAMBIO DE RESOLUCIÓN

La resolución de la retransmisión ha cambiado.

Véase también: : - [Valores de campo constantes]

VIDEO_MOTIVO_CAMBIO_DE_CÓDEC

public static final Cadena VIDEO_MOTIVO_CAMBIO_DE_CÓDEC

Ha cambiado el códec de vídeo de la transmisión.

Véase también: : - [Valores de campo constantes]

MOTIVO_DE_RED_CAMBIO_EN_LAS_CONDICIONES_DE_LA_RED

public static final Cadena MOTIVO_DE_RED_CAMBIO_EN_LAS_CONDICIONES_DE_LA_RED

Indica que el estado de la red del participante local o remoto ha cambiado. Este evento se activa cuando se detecta un cambio significativo en el estado de la red del editor o del suscriptor.

Véase también: : - [Valores de campo constantes]

NO_RESOLUCIÓN_PREFERIDA

public static final VideoUtils.Size NO_RESOLUCIÓN_PREFERIDA

Define un valor de reinicio que se pasa a la función setPreferredResolution(VideoUtils.Size preferredResolution) método. Pasa este valor para restablecer el suscriptor de modo que no tenga una resolución preferida. El suscriptor utilizará la resolución máxima disponible, en función de las condiciones.

Esto solo se aplica a las transmisiones publicadas mediante la función de vídeo escalable .

NO_PREFERRED_FRAMERATE

public static final float NO_PREFERRED_FRAMERATE

Define un valor de reinicio que se pasa a la función setPreferredFrameRate(float preferredFrameRate) método. Pasa este valor para restablecer el suscriptor de modo que no tenga una frecuencia de fotogramas preferida. El suscriptor utilizará la frecuencia de fotogramas máxima disponible, en función de las condiciones.

Esto solo se aplica a las transmisiones publicadas mediante la función de vídeo escalable.

Véase también: : - [Valores de campo constantes]

sesión

protegido Sesión sesión

motor de renderizado

protegido BaseVideoRenderer motor de renderizado

corriente

protegido Transmisión corriente

Datos del constructor

SubscriberKit

protected SubscriberKit(SubscriberKit.Builder constructor)

Detalles del método

destruir

@Obsoleto public void destruir()

En desuso.

Destruir el objeto manualmente no es seguro. A partir de la versión 2.17.0, este método no hace nada. El recolector de basura liberará automáticamente los recursos.

setSubscriberListener

public void setSubscriberListener(SubscriberKit.SubscriberListener oyente)

Establece un SubscriberKit.SubscriberListener objeto para supervisar los cambios de estado.

Parámetros: : listener - El SubscriberKit.SubscriberListener que supervisa esta instancia de SubscriberKit.

setVideoListener

public void setVideoListener(SubscriberKit.VideoListener oyente)

Establece un SubscriberKit.VideoListener objeto para supervisar cuándo el suscriptor empieza y deja de recibir vídeo.

Parámetros: : listener - El SubscriberKit.VideoListener instancia.

setAudioLevelListener

public void setAudioLevelListener(SubscriberKit.AudioLevelListener oyente)

Asigna un SubscriberKit.AudioLevelListener a esta instancia de SubscriberKit para supervisar las actualizaciones del nivel de audio.

Parámetros: : listener - El SubscriberKit.AudioLevelListener que supervisará esta instancia. Establece este valor en «null» para desconectar un oyente y dejar de supervisar los niveles de audio.

setCaptionsListener

public void setCaptionsListener(SubscriberKit.CaptionsListener oyente)

Asigna un SubscriberKit.CaptionsListener a esta instancia de SubscriberKit para recibir subtítulos.

Parámetros: : listener - El SubscriberKit.CaptionsListener que supervisará esta instancia. Establece este valor en «null» para desconectar un oyente y dejar de recibir subtítulos.

setAudioVolume

public void setAudioVolume(double volumen)

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

Parámetros: : volume - El volumen del abonado.

getAudioVolume

public double getAudioVolume()

Devuelve el volumen de audio del abonado, en un rango comprendido entre 0 y 100.

El valor por defecto es 100.

setStreamListener

public void setStreamListener(SubscriberKit.StreamListener oyente)

Configura un oyente para los eventos relacionados con la interrupción y la reanudación del flujo del suscriptor.

getSession

público Sesión getSession()

Devuelve el Session que el abonado está obligado a (al llamar al connect() método del objeto Session).

Devoluciones: : El Session a las que está sujeto el abonado.

getStream

público Transmisión getStream()

Devuelve el Stream a la que está vinculada esta instancia. Cualquier canal multimedia del flujo debería estar disponible para su visualización o reproducción con esta instancia.

Devoluciones: : El Stream a la que está vinculada esta instancia.

getSubscribeToAudio

public boolean getSubscribeToAudio()

Independientemente de si el suscriptor está suscrito al contenido de audio o no.

Valores devueltos: : true si el suscriptor se está suscribiendo al audio; false si no es así.

getSubscribeToVideo

public boolean getSubscribeToVideo()

Independientemente de si el suscriptor está suscrito al contenido de audio o no.

Valores devueltos: : true si el suscriptor se está suscribiendo al audio; false si no es así.

getSubscribeToCaptions

public boolean getSubscribeToCaptions()

Independientemente de si el suscriptor está suscrito a los subtítulos o no.

Devuelve: : true si el suscriptor está suscrito a los subtítulos; false si no lo está. El valor por defecto es el valor de los subtítulos de su editor. PublisherKit.setPublishCaptions(boolean).

setSubscribeToAudio

public void setSubscribeToAudio(boolean subscribeToAudio)

Si se desea suscribirse al audio del canal (true) o no (false). Establecer esta propiedad no tiene ningún efecto si el hasAudio método del objeto Stream devuelve false.

Parámetros: : subscribeToAudio - Si se desea suscribirse al audio de la transmisión (true) o no (false).

setSubscribeToVideo

public void setSubscribeToVideo(boolean subscribeToVideo)

Si quieres suscribirte al canal de vídeos (true) o no (false). Establecer esta propiedad no tiene ningún efecto si el hasVideo método del objeto Stream devuelve false.

Parámetros: : subscribeToVideo - Si quieres suscribirte al canal de vídeos (true) o no (false).

setSubscribeToCaptions

public void setSubscribeToCaptions(boolean subscribeToCaptions)

Si quieres suscribirte a los subtítulos de la retransmisión (true) o no (false)..

Parámetros: : subscribeToCaptions - Si quieres suscribirte a los subtítulos de la retransmisión (true) o no (false).

setCaptionsTranslationLanguage

public void setCaptionsTranslationLanguage(Cadena idioma)

Establece el idioma preferido para la traducción de los subtítulos de este suscriptor.

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

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

Esta es una función en fase beta privada.

Parámetros: : language - Un código de idioma BCP-47 compatible, o null para desactivar la traducción.

getCaptionsTranslationLanguage

público Cadena getCaptionsTranslationLanguage()

Obtiene el idioma de traducción de los subtítulos configurado para este suscriptor.

Esta es una función en fase beta privada.

Valores de retorno: : El código de idioma BCP-47 configurado, o null si no se ha configurado la traducción.

setStyle

public void setStyle(Cadena clave, Cadena valor)

Establece un estilo utilizado por este suscriptor.

Por defecto, solo hay una clave de estilo predefinida: BaseVideoRenderer.STYLE_VIDEO_SCALE. Puedes establecer un valor para esta clave para determinar el escalado del vídeo. Se admiten los siguientes valores:

BaseVideoRenderer.STYLE_VIDEO_FILL — El vídeo se ajusta para ocupar toda la superficie del visor, recortándose según sea necesario.
BaseVideoRenderer.STYLE_VIDEO_FIT — El vídeo se reduce, según sea necesario, para que se vea completo, con bandas negras a los lados (la configuración predeterminada).

Llamar a este método equivale a llamar a getRenderer().setStyle(). Sin embargo, si extiendes esta clase, puedes sobrescribir este método para admitir otros estilos y comportamientos.

Parámetros: : key - El estilo que hay que establecer. : value - El valor al que estás aplicando el estilo.

setRenderer

@Obsoleto public void setRenderer(BaseVideoRenderer renderizador)

En desuso.

Configura el renderizador de vídeo para este suscriptor.

Este método está obsoleto. En su lugar, llama a el SubscriberKit.Builder.renderer(BaseVideoRenderer renderer) método al utilizar el Builder para crear la instancia de SubscriberKit.

getRenderer

público BaseVideoRenderer getRenderer()

Devuelve el renderizador de vídeo de este suscriptor.

getView

public android.view.View getView()

Devuelve el objeto `android.view.View` que contiene el vídeo del suscriptor.

setVideoStatsListener

public void setVideoStatsListener(SubscriberKit.VideoStatsListener oyente)

Configura un oyente para las estadísticas de vídeo de los suscriptores. El objeto oyente implementa la interfaz SubscriberKit.VideoStatsListener.onVideoStats(SubscriberKit subscriber, SubscriberKit.SubscriberVideoStats stats) método. Este método se invoca periódicamente para informar de lo siguiente:

Total de paquetes de vídeo perdidos
Total de paquetes de vídeo recibidos
Total de bytes de vídeo recibidos

Véase también: : - setAudioStatsListener(AudioStatsListener listener)

setAudioStatsListener

public void setAudioStatsListener(SubscriberKit.AudioStatsListener oyente)

Configura un oyente para las estadísticas de audio de los suscriptores. El objeto oyente implementa la interfaz SubscriberKit.AudioStatsListener.onAudioStats(SubscriberKit subscriber, SubscriberKit.SubscriberAudioStats stats) método. Este método se invoca periódicamente para informar de lo siguiente:

Total de paquetes de audio perdidos
Total de paquetes de audio recibidos
Total de bytes de audio recibidos

Véase también: : - setVideoStatsListener(VideoStatsListener listener)

setMediaLinkStatsListener

public void setMediaLinkStatsListener(SubscriberKit.MediaLinkStatsListener oyente)

Configura un oyente para las estadísticas de enlaces multimedia de los suscriptores. El objeto oyente implementa la interfaz SubscriberKit.MediaLinkStatsListener interfaz, que incluye:

SubscriberKit.MediaLinkStatsListener.onMediaLinkStats(SubscriberKit, SubscriberMediaLinkStats) — que se ejecuta periódicamente con métricas a nivel de transporte.
SubscriberKit.MediaLinkStatsListener.onNetworkConditionChanged(SubscriberKit, SubscriberMediaLinkStats, String) — se ejecuta cuando cambia el estado de la red.

Parámetros: : listener - El SubscriberKit.MediaLinkStatsListener instancia, o «null» para eliminar el oyente.

setPreferredResolution

public void setPreferredResolution(VideoUtils.Size resoluciónPreferida)

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

Limitar la resolución y la frecuencia de fotogramas del vídeo (véase setPreferredFrameRate(float preferredFrameRate)) reduce el uso de la red y de la CPU en el cliente suscrito. Es posible que te interese utilizar una resolución menor 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 menor 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 medios modo enrutado).
Solo para flujos publicados por clientes que admitan vídeo escalable (consulta la documentación sobre el escalable función de vídeo).

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 establecer una resolución máxima para este suscriptor.

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

No todas las resoluciones están disponibles para un suscriptor. Cuando estableces la resolución preferida, el SDK de OpenTok para Android selecciona la mejor resolución disponible que se ajuste a tus limitaciones. Las resoluciones disponibles dependen del ancho y la altura máximos que el editor establezca para la transmisión, los cuales son devueltos por el Stream.getVideoWidth() y Stream.getVideoHeight() métodos del objeto Stream. Cada una de las resoluciones disponibles para un flujo utilizará la misma relación de aspecto.

Pasa el balón a SubscriberKit.NO_PREFERRED_RESOLUTION para restablecer el abonado de modo que no tenga una resolución preferida. El abonado utilizará la resolución máxima disponible, en función de las condiciones.

setPreferredFrameRate

public void setPreferredFrameRate(float preferredFrameRate)

Establece la frecuencia de fotogramas preferida para la transmisión del suscriptor.

Limitar la frecuencia de fotogramas y la resolución del vídeo (véase setPreferredResolution(VideoUtils.Size preferredResolution)) reduce el uso de la red y de la CPU en el cliente suscriptor. 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 medios modo enrutado).
Solo para flujos publicados por clientes que admitan vídeo escalable (consulta la documentación sobre el escalable función de vídeo).

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 establecer una frecuencia de fotogramas máxima 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 Android selecciona la mejor velocidad de fotogramas disponible que más se acerque a la velocidad preferida, en función del ancho de banda del cliente y de las limitaciones de la CPU.

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

Pasa el balón a SubscriberKit.NO_PREFERRED_FRAMERATE para restablecer el abonado de modo que no tenga una frecuencia de fotogramas preferida. El abonado utilizará la frecuencia de fotogramas máxima disponible, en función de las condiciones.

getPreferredResolution

público VideoUtils.Size getPreferredResolution()

Devuelve la resolución preferida para la transmisión del suscriptor. Este método solo se aplica a las transmisiones publicadas mediante la función de vídeo escalable. Véase setPreferredResolution(VideoUtils.Size preferredResolution).

setRtcStatsReportListener

public void setRtcStatsReportListener(SubscriberKit.SubscriberRtcStatsReportListener oyente)

Establece el oyente del informe de estadísticas de RTC para el suscriptor. Véase getRtcStatsReport().

Parámetros: : listener - El SubscriberKit.SubscriberRtcStatsReportListener objeto.

getRtcStatsReport

public void obtenerInformeDeEstadísticasRtc()

Obtiene el informe de estadísticas RTC del suscriptor. Se trata de una operación asíncrona. Llama al método SubscriberKit#setRtcStatsReportListener(SubscriberRtcStatsReportListener listener) y, a continuación, implementa el SubscriberKit.SubscriberRtcStatsReportListener.onRtcStatsReport(SubscriberKit subscriber, String jsonArrayOfReports) método antes de llamar a este método. Cuando las estadísticas estén disponibles, la implementación del SubscriberKit.SubscriberRtcStatsReportListener.onRtcStatsReport(SubscriberKit subscriber, String jsonArrayOfReports) se llama el método.

Véase también setAudioStatsListener(SubscriberKit.AudioStatsListener listener), setVideoStatsListener(SubscriberKit.VideoStatsListener listener), y PublisherKit.getRtcStatsReport().

onRtcStatsReport

protected void onRtcStatsReport(Cadena jsonArrayOfReports)

Se invoca cuando el informe de estadísticas RTC del abonado está disponible en respuesta a una llamada a getRtcStatsReport().

Si extiendes la clase `SubscriberKit`, puedes sobrescribir este método en lugar de implementar el método `onRtcStatsReport()` de la interfaz `SubscriberKit.SubscriberRtcStatsReportListener`.

Véase onRtcStatsReport(String jsonArrayOfReports).

getPreferredFrameRate

public float getPreferredFrameRate()

Devuelve la frecuencia de fotogramas preferida para la transmisión del suscriptor. Este método solo se aplica a las transmisiones publicadas mediante la función de vídeo escalable. Véase setPreferredFrameRate(float preferredFrameRate).

Devuelve: : La frecuencia de fotogramas preferida para la transmisión del suscriptor o -1 si se ha producido algún error al recuperar el valor real.

onConnected

protected void onConnected()

Se invoca cuando la instancia se ha conectado correctamente al flujo y comienza a reproducir contenido multimedia.

Si extiendes la clase `SubscriberKit`, puedes sobrescribir este método en lugar del onConnected() método de la interfaz `SubscriberKit.SubscriberListener`.

onDisconnected

@Obsoleto protected void onDisconnected()

En desuso.

A partir de la versión 2.17.0, esta función de devolución de llamada ya no se ejecutará. Cuando un suscriptor se desconecta de la sesión, el Session.SessionListener.onStreamDropped(com.opentok.android.Session, com.opentok.android.Stream) Se ejecutará la función de devolución de llamada.

onError

protected void onError(OpentokError (error)

Se activa cuando un suscriptor no ha podido conectarse al servidor de OpenTok.

Si extiendes la clase `SubscriberKit`, puedes sobrescribir este método en lugar del onError() método de la interfaz `SubscriberKit.SubscriberListener`.

Parámetros: : error - El error.

onStreamDisconnected

protected void onStreamDisconnected()

Se invoca cuando se ha interrumpido la transmisión del suscriptor.

Al ejecutarse este método, es posible que desees mostrar una notificación en la interfaz de usuario para informar al usuario de que la transmisión de audio y vídeo se ha desconectado temporalmente y de que la aplicación está intentando volver a conectarse a la transmisión.

Si el cliente se vuelve a conectar a la transmisión, el onStreamReconnected() se llama el método. De lo contrario, el onDisconnected() se llama al método.

Si heredas de la clase `SubscriberKit`, puedes sobrescribir este método en lugar de implementar el onDisconnected() método de la interfaz SubscriberKit.StreamListener.

onStreamReconnected

protected void onStreamReconnected()

Se invoca cuando se ha reanudado la transmisión del suscriptor, tras el onStreamDisconnected() se llama al método.

Si heredas de la clase `SubscriberKit`, puedes sobrescribir este método en lugar de implementar el onReconnected() método de la interfaz SubscriberKit.StreamListener.

onAudioEnabled

protected void onAudioEnabled()

Se invoca cuando el flujo del suscriptor tiene el audio activado.

Si heredas de la clase `SubscriberKit`, puedes sobrescribir este método en lugar de implementar el onAudioEnabled() método de la interfaz SubscriberKit.StreamListener.

onAudioDisabled

protected void onAudioDisabled()

Se activa cuando se ha desactivado el flujo de audio del suscriptor

Si heredas de la clase `SubscriberKit`, puedes sobrescribir este método en lugar de implementar el onAudioDisabled() método de la interfaz SubscriberKit.StreamListener.

onVideoDisabled

protected void onVideoDisabled(Cadena (razón)

Se invoca cuando el suscriptor deja de recibir el vídeo. Comprueba el parámetro «reason» para conocer el motivo por el que se ha detenido el vídeo.

Si extiendes la clase `SubscriberKit`, puedes sobrescribir este método en lugar del onVideoDisabled() método de la interfaz `SubscriberKit.SubscriberListener`.

Parámetros: : reason - El motivo por el que se desactivó la pista de vídeo. Este valor se establece en uno de los siguientes: VIDEO_REASON_PUBLISH_VIDEO VIDEO_REASON_SUBSCRIBE_TO_VIDEO, VIDEO_REASON_QUALITY, o VIDEO_REASON_CODEC_NOT_SUPPORTED.

onVideoEnabled

protected void onVideoEnabled(Cadena (razón)

Se invoca cuando se inicia la transmisión de vídeo del suscriptor (cuando antes no había vídeo) o cuando se reanuda (tras haber desactivado el vídeo). Consulta el parámetro «reason» para conocer el motivo por el que se detuvo el vídeo.

Si extiendes la clase `SubscriberKit`, puedes sobrescribir este método en lugar del onVideoEnabled() método de la interfaz `SubscriberKit.SubscriberListener`.

Parámetros: : reason - El motivo por el que se inició o se reanudó la pista de vídeo. Este valor se establece en uno de los siguientes valores: VIDEO_REASON_PUBLISH_VIDEO VIDEO_REASON_SUBSCRIBE_TO_VIDEO, o VIDEO_REASON_QUALITY.

onVideoDisableWarning

protected void onVideoDisableWarning()

Se invoca cuando el OpenTok Media Router detecta que la calidad de la transmisión se ha deteriorado y que el vídeo se desactivará si la calidad sigue empeorando. Si la calidad sigue empeorando, el suscriptor desactiva el vídeo y el onVideoDisabled(String reason) se llama el método. Si la calidad de la transmisión mejora, el onVideoDisableWarningLifted() se llama al método.

Esta función solo está disponible en sesiones que utilicen el OpenTok Media Router (sesiones con el modo multimedia configurado en «routed»), no en sesiones con el modo multimedia configurado en «relayed». (Véase El enrutador multimedia de OpenTok y los modos multimedia).

Este método se invoca principalmente cuando la calidad de la conexión se deteriora.

Si extiendes la clase `SubscriberKit`, puedes sobrescribir este método en lugar del onVideoDisableWarning() método de la interfaz SubscriberKit.SubscriberListener.

onVideoDisableWarningLifted

protected void onVideoDisableWarningLifted()

Se invoca cuando el OpenTok Media Router determina que la calidad de la transmisión ha mejorado hasta el punto de que la desactivación del vídeo no supone un riesgo inmediato. Este método se invoca después de que el onVideoDisableWarning() se llama el método.

Esta función solo está disponible en las sesiones que utilizan el OpenTok Media Router (sesiones con el modo multimedia configurado en «routed»), no en las sesiones con el modo multimedia configurado en «relayed». (Véase El enrutador multimedia de OpenTok y los modos multimedia.)

Este método se activa principalmente cuando mejora la calidad de la conexión.

Si heredas de la clase `SubscriberKit`, puedes sobrescribir este método en lugar de el onVideoDisableWarningLifted() método de la interfaz `SubscriberKit.SubscriberListener`.

onVideoDataReceived

protected void onVideoDataReceived()

Se invoca cuando un suscriptor recibe datos de vídeo por primera vez.

Si extiendes la clase `SubscriberKit`, puedes sobrescribir este método en lugar del onVideoDataReceived() método de la interfaz SubscriberKit.VideoListener.

attachToSession

protected void attachToSession(Sesión sesión)

desconectarDeSesión

protected void desvincularDeSesión(Sesión sesión)

onAudioLevelUpdated

protected void onAudioLevelUpdated(float audioLevel)

onCaptionText

protected void onCaptionText(Cadena texto, booleano isFinal)

onPause

public void onPause()

No llames directamente; llama a Session.onPause() en su lugar.

onResume

public void onResume()

No llames directamente; llama a Session.onResume() en su lugar.

actualización

@Obsoleto public void update(Observable o, Objeto arg)

En desuso.

Este método se invoca cada vez que se produce un cambio en el objeto observado. Esta clase implementa la interfaz Observer, por lo que observa eventos, como los de pausa y reanudación de la sesión.

Especificado por: : update en la interfaz Observer

Parámetros: : o - El objeto observable. : arg - Un argumento pasado al método `notifyObservers`.

finalizar

protected void finalize() throws Lanzable

El recolector de basura la invoca en un objeto `SubscriberKit` cuando determina que ya no hay referencias al objeto.

Sobrescrituras: : finalize en clase Object

Lanzamientos: : Throwable