com.opentok.android.PublisherKit
Todas las interfaces implementadas:
: Observer
Subclases conocidas directas:
: Publisher
clase pública PublisherKit extende Objeto herramientas Observador
Un editor captura un flujo de audio y vídeo de las fuentes que especifiques. A continuación,
puedes publicar el flujo de audio y vídeo en una sesión de OpenTok llamando a la función
Session.publish(PublisherKit publisher) método.
Crea una subclase de PublisherKit si te interesa proporcionar tu propia
implementación de captura y renderización de vídeo. De lo contrario, utiliza el Publisher
clase, que incluye un capturador y un renderizador de vídeo integrados.
Resumen de clases anidadas
Clases anidadas
Modificador y tipo
Clase
Descripción
static interface
PublisherKit.AudioLevelListener
Supervisa los cambios en el nivel de audio del emisor.
static interface
PublisherKit.AudioStatsListener
Define el objeto de escucha para obtener las estadísticas de audio del emisor.
class
PublisherKit.AudioTransformer
Un transformador para un flujo de audio.
static class
PublisherKit.Builder
Se utiliza para crear un PublisherKit objeto.
static interface
PublisherKit.CustomAudioTransformer
Define un transformador personalizado para un flujo de audio, que se pasará al
PublisherKit.AudioTransformer
constructor.
static interface
PublisherKit.CustomVideoTransformer
Define un transformador personalizado para un flujo de vídeo, que se pasará al
PublisherKit.VideoTransformer
constructor.
static enum
PublisherKit.DegradationPreference
Describe la política que el motor de vídeo intentará seguir a la hora de adaptar la frecuencia de fotogramas y la resolución a un ancho de banda y una CPU limitados.
static interface
PublisherKit.MediaLinkStatsListener
Define el objeto de escucha para obtener estadísticas sobre los enlaces multimedia del editor.
static interface
PublisherKit.MuteListener
Detecta cuándo un moderador ha obligado a este emisor a silenciar el audio.
static final class
PublisherKit.PreferredVideoCodecs
Define las preferencias de códecs para la publicación de vídeos.
static class
PublisherKit.PublisherAudioStats
Define las estadísticas de audio de un editor.
static enum
PublisherKit.PublisherKitVideoType
Define los valores para el setPublisherVideoType(PublisherKitVideoType type) método.
static interface
PublisherKit.PublisherListener
Supervisa cuándo un editor inicia y detiene la transmisión a la sesión.
static class
PublisherKit.PublisherMediaLinkStats
Proporciona estadísticas sobre los enlaces multimedia de los editores, incluidas las métricas de tráfico local.
static class
PublisherKit.PublisherRtcStats
Representa las estadísticas de RTC de una transmisión multimedia publicada por el editor.
static interface
PublisherKit.PublisherRtcStatsReportListener
Define el objeto de escucha para obtener los informes de estadísticas RTC del editor.
static class
PublisherKit.PublisherVideoStats
Define las estadísticas de vídeo de un editor.
static enum
PublisherKit.VideoBitratePreset
Define los valores para el setVideoBitratePreset(VideoBitratePreset preset) método.
static class
PublisherKit.VideoLayerStats
Representa las estadísticas de una única capa de vídeo publicada.
static interface
PublisherKit.VideoListener
Supervisa cuándo el editor empieza y deja de recibir datos de vídeo.
static interface
PublisherKit.VideoStatsListener
Define el objeto de escucha para obtener las estadísticas de vídeo del editor.
class
PublisherKit.VideoTransformer
Un transformador para una transmisión de vídeo.
Resumen del campo
Campos
Modificador y tipo
Campo
Descripción
protected PublisherKit.AudioLevelListener
audioLevelListener
protected PublisherKit.AudioStatsListener
audioStatsListener
protected BaseVideoCapturer
capturer
protected android.content.Context
context
protected android.os.Handler
handler
protected PublisherKit.MediaLinkStatsListener
mediaLinkStatsListener
protected PublisherKit.MuteListener
muteListener
static final String
NETWORK_REASON_NETWORK_CONDITION_CHANGE
Indica que el estado de la red del participante local ha cambiado.
protected PublisherKit.PublisherListener
publisherListener
protected BaseVideoRenderer
renderer
protected PublisherKit.PublisherRtcStatsReportListener
rtcStatsReportListener
static final String
VIDEO_REASON_CODEC_CHANGE
Ha cambiado el códec de vídeo de la transmisión.
static final String
VIDEO_REASON_NONE
static final String
VIDEO_REASON_QUALITY
El problema con el vídeo se debió a un cambio en el nivel de congestión de la red.
static final String
VIDEO_REASON_QUALITY_DEGRADATION_BANDWIDTH
Deterioro de la calidad debido a un ancho de banda de red insuficiente.
static final String
VIDEO_REASON_QUALITY_DEGRADATION_CPU
Deterioro de la calidad provocado por las limitaciones de la CPU del dispositivo cliente.
static final String
VIDEO_REASON_QUALITY_DEGRADATION_OTHER
Deterioro de la calidad provocado por otras causas.
static final String
VIDEO_REASON_RESOLUTION_CHANGE
Cambio en la resolución del vídeo o en el número de capas.
protected PublisherKit.VideoListener
videoListener
protected PublisherKit.VideoStatsListener
videoStatsListener
Resumen del constructor
Constructores
Modificador
Constructor
Descripción
protected
PublisherKit(PublisherKit.Builder builder)
Resumen del método
Todos los métodosMétodos de instanciaMétodos concretosMétodos obsoletos
Modificador y tipo
Método
Descripción
void
destroy()
Libera este objeto, incluidos todos los recursos de hardware y de la interfaz de usuario asociados a él, si el recolector de basura no puede liberarlo.
protected void
finalize()
El recolector de basura lo invoca cuando determina que ya no hay referencias al objeto PublisherKit.
BaseVideoCapturer
getCapturer()
Devuelve el capturador de vídeo que utiliza este editor.
PublisherKit.DegradationPreference
getDegradationPreference()
Obtiene la política preferida que seguirá el motor de vídeo a la hora de ajustar la frecuencia de fotogramas y la resolución en función de las limitaciones de ancho de banda y las condiciones de la CPU.
int
getMaxVideoBitrate()
Obtiene la tasa de bits máxima del vídeo para la transmisión del editor, en bits por segundo.
String
getName()
El nombre del flujo.
boolean
getPublishAudio()
Independientemente de si la editorial publica contenido de audio (true) o no (
false).
boolean
getPublishCaptions()
Si el editor publica subtítulos (true) o no (
false).
PublisherKit.PublisherKitVideoType
getPublisherVideoType()
Devuelve el tipo de vídeo de este editor.
boolean
getPublishVideo()
Independientemente de si el editor publica vídeos (true) o no (
false).
BaseVideoRenderer
getRenderer()
Devuelve el renderizador de vídeo de este editor.
void
getRtcStatsReport()
Obtiene el informe de estadísticas de RTC correspondiente al editor.
Session
getSession()
Devuelve el Session vinculado a esta instancia de Publisher.
Stream
getStream()
Devuelve el objeto de flujo correspondiente al flujo del Publisher.
String
getTargetScalabilityMode()
Obtiene el modo de escalabilidad de destino que se ha establecido explícitamente mediante setTargetScalabilityMode.
PublisherKit.VideoBitratePreset
getVideoBitratePreset()
Obtiene el ajuste preestablecido de velocidad de bits de vídeo actualmente activo para la transmisión del editor.
android.view.View
getView()
Devuelve el objeto `android.view.View` que contiene el vídeo de `Publisher`.
protected void
onAudioLevelUpdated(float audioLevel)
Se invoca periódicamente para informar del nivel de audio del editor.
protected void
onError(OpentokError error)
Se invoca cuando el editor falla.
protected void
onMuteForced()
Se activa cuando un moderador ha obligado a este editor a silenciar el audio.
void
onPause()
No llames directamente; llama a Session.onPause() en su lugar.
void
onRestart()
Reinicia los recursos del editor que se habían liberado anteriormente mediante la llamada a la función
onStop() método.
void
onResume()
No llames directamente; llama a Session.onResume() en su lugar.
protected void
onRtcStatsReport(PublisherKit.PublisherRtcStats[] stats)
Se invoca cuando el informe de estadísticas RTC del editor está disponible, en respuesta a una
llamada a getRtcStatsReport().
void
onStop()
Libera los recursos vinculados al editor.
protected void
onStreamCreated(Stream stream)
Se invoca cuando se crea el flujo del editor.
protected void
onStreamDestroyed(Stream stream)
Se invoca cuando se destruye el flujo del editor.
void
setAudioLevelListener(PublisherKit.AudioLevelListener listener)
Asigna un PublisherKit.AudioLevelListener a esta instancia de PublisherKit para supervisar
las actualizaciones del nivel de audio.
void
setAudioStatsListener(PublisherKit.AudioStatsListener listener)
Configura un oyente para las estadísticas de audio del editor.
void
setAudioTransformers(ArrayList<PublisherKit.AudioTransformer> audioTransformers)
Establece una lista de transformadores de audio para el flujo de audio de este editor.
void
setCapturer(BaseVideoCapturer newCapturer)
En desuso.
void
setDegradationPreference(PublisherKit.DegradationPreference degradationPreference)
Obtiene la política preferida que seguirá el motor de vídeo a la hora de ajustar la frecuencia de fotogramas y la resolución en función de las limitaciones de ancho de banda y las condiciones de la CPU.
void
setMaxVideoBitrate(int maxVideoBitrate)
Establece la tasa de bits máxima de vídeo para la transmisión de vídeo del editor, en bits por segundo.
void
setMediaLinkStatsListener(PublisherKit.MediaLinkStatsListener listener)
Configura un oyente para las estadísticas de enlaces multimedia del editor.
void
setMuteListener(PublisherKit.MuteListener listener)
Establece un PublisherKit.MuteListener objeto que permite supervisar cuándo un moderador obliga
a este editor a silenciar el audio.
void
setName(String name)
En desuso.
void
setPublishAudio(boolean publishAudio)
Activa o desactiva la reproducción de audio, en función del valor que se le pase.
void
setPublishCaptions(boolean publishCaptions)
Activa o desactiva la publicación de los subtítulos, en función del valor que se le pase.
void
setPublisherListener(PublisherKit.PublisherListener listener)
Asigna un PublisherKit.PublisherListener a esta instancia de Publisher para supervisar los
cambios de estado.
void
setPublisherVideoType(PublisherKit.PublisherKitVideoType type)
Especifica el tipo de vídeo de esta transmisión.
void
setPublishVideo(boolean publishVideo)
Activa o desactiva la publicación del vídeo, en función del valor que se le pase.
void
setRenderer(BaseVideoRenderer renderer)
En desuso.
void
setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener listener)
Establece al suscriptor como receptor del informe de estadísticas del RTC.
void
setStyle(String key, String value)
Establece un estilo para el renderizador de vídeo que utiliza este editor.
void
setTargetScalabilityMode(String scalabilityMode)
Establece el modo de escalabilidad deseado (SVC: codificación de vídeo escalable) para este editor.
void
setVideoBitratePreset(PublisherKit.VideoBitratePreset videoBitratePreset)
Establece una estrategia predefinida de velocidad de bits de vídeo para la transmisión de vídeo del editor.
void
setVideoListener(PublisherKit.VideoListener listener)
Establece un PublisherKit.VideoListener objeto para supervisar cuándo el editor comienza
y deja de enviar vídeo.
void
setVideoStatsListener(PublisherKit.VideoStatsListener listener)
Configura un oyente para las estadísticas de vídeo del editor.
void
setVideoTransformers(ArrayList<PublisherKit.VideoTransformer> videoTransformers)
Establece una lista de transformadores de vídeo para la transmisión de vídeo de este editor.
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_CALIDAD
public static final Cadena VÍDEO_MOTIVO_CALIDAD
El problema con el vídeo se debió a un cambio en el nivel de congestión de la red.
El
PublisherKit.VideoListener.onVideoDisabled(PublisherKit, String) se llama
el método.
Cuando las condiciones mejoran, la transmisión de vídeo se reanuda, y el
PublisherKit.VideoListener.onVideoEnabled(PublisherKit, 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.
Véase también:
: - method.
- method.
- [Valores de campo constantes]
VÍDEO_MOTIVO_DETERIORO_DE_LA_CALIDAD_ANCHO_DE_BANDA
public static final Cadena VÍDEO_MOTIVO_DETERIORO_DE_LA_CALIDAD_ANCHO_DE_BANDA
Deterioro de la calidad debido a un ancho de banda de red insuficiente.
Véase también: : - [Valores de campo constantes]
VÍDEO_MOTIVO_DETERIORO_DE_LA_CALIDAD_CPU
public static final Cadena VÍDEO_MOTIVO_DETERIORO_DE_LA_CALIDAD_CPU
Deterioro de la calidad provocado por las limitaciones de la CPU del dispositivo cliente.
Véase también: : - [Valores de campo constantes]
VÍDEO_MOTIVO_DETERIORO_DE_LA_CALIDAD_OTROS
public static final Cadena VÍDEO_MOTIVO_DETERIORO_DE_LA_CALIDAD_OTROS
Deterioro de la calidad provocado por otras causas.
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]
VÍDEO_MOTIVO_CAMBIO DE RESOLUCIÓN
public static final Cadena VÍDEO_MOTIVO_CAMBIO DE RESOLUCIÓN
Cambio en la resolución del vídeo o en el número de capas. Esto puede deberse a limitaciones en la tasa de bits, a la adaptación del codificador, a cambios en la fuente de la cámara (por ejemplo, al cambiar de cámara o modificar la resolución de entrada) o a cambios en la configuración. No siempre implica una pérdida de calidad.
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 ha cambiado. Este evento se activa cuando se detecta un cambio significativo en el estado de la red.
Véase también: : - [Valores de campo constantes]
gestor
handler protegido de tipo android.os.Handler
publisherListener
protegido PublisherKit.PublisherListener publisherListener
audioLevelListener
protegido PublisherKit.AudioLevelListener audioLevelListener
videoStatsListener
protegido PublisherKit.VideoStatsListener videoStatsListener
audioStatsListener
protegido PublisherKit.AudioStatsListener audioStatsListener
mediaLinkStatsListener
protegido PublisherKit.MediaLinkStatsListener mediaLinkStatsListener
muteListener
protegido PublisherKit.MuteListener muteListener
rtcStatsReportListener
protegido PublisherKit.PublisherRtcStatsReportListener rtcStatsReportListener
contexto
protected android.content.Context context
motor de renderizado
protegido BaseVideoRenderer motor de renderizado
capturador
protegido BaseVideoCapturer capturador
videoListener
protegido PublisherKit.VideoListener videoListener
Datos del constructor
PublisherKit
protected PublisherKit(PublisherKit.Builder constructor)
Detalles del método
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.
destruir
public void destruir()
Libera este objeto, incluidos todos los recursos de hardware y de la interfaz de usuario asociados a él, si el recolector de basura no puede liberarlo. Por lo general, el recolector de basura libera los recursos de forma segura, por lo que no es necesario llamar a este método. Sin embargo, esto puede ocurrir en cualquier momento a discreción de la máquina virtual, lo que en algunos casos podría no ser el comportamiento deseado. Este método permite liberar recursos manualmente en situaciones en las que se requiere una respuesta inmediata:
- Una aplicación quiere volver a publicarse, pero necesita tener acceso a la cámara inmediatamente después de dejar de publicarse.
- Una aplicación quiere asegurarse de que el dispositivo de audio quede liberado inmediatamente después de dejar de publicarse.
Una vez que hayas llamado a este método, no podrás volver a utilizar el editor.
setPublishVideo
public void setPublishVideo(boolean publishVideo)
Activa o desactiva la publicación del vídeo, en función del valor que se le pase.
Parámetros:
: publishVideo - Si se debe publicar el vídeo (true) o no (
false).
setPublishAudio
public void setPublishAudio(boolean publishAudio)
Activa o desactiva la reproducción de audio, en función del valor que se le pase.
Parámetros:
: publishAudio - Si se debe publicar el audio (true) o no (
false).
setPublishCaptions
public void setPublishCaptions(boolean publishCaptions)
Activa o desactiva la publicación de los subtítulos, en función del valor que se le pase.
Parámetros:
: publishCaptions - Si se deben publicar los pies de foto (true) o no (
false).
setName
@Obsoleto public void setName(Cadena nombre)
En desuso.
Establece el nombre de esta transmisión. El nombre aparece en la parte inferior del
vídeo del editor y en la parte inferior de los vídeos de los suscriptores asociados a
la transmisión publicada. Puedes establecer este nombre tras inicializar el
editor y antes de que
PublisherKit.PublisherListener.onStreamCreated(PublisherKit publisher, Stream stream)
se llama al método. Al establecer la propiedad después de la
PublisherKit.PublisherListener.onStreamCreated(PublisherKit publisher, Stream stream)
El método al que se llama no influye en el nombre que se muestra para el flujo.
El nombre por defecto es «» (una cadena vacía).
setPublisherVideoType
public void setPublisherVideoType(PublisherKit.PublisherKitVideoType tipo)
Especifica el tipo de vídeo de esta transmisión. Establece este valor en uno de los siguientes valores:
PublisherKitVideoType.PublisherKitVideoTypeScreen— Optimiza la codificación de vídeo para compartir pantalla. Se recomienda utilizar una frecuencia de fotogramas baja (5 fotogramas por segundo o menos) con este tipo de vídeo. Véase El OpenTok Media Router y los modos multimedia.PublisherKitVideoType.PublisherKitVideoTypeCamera— Esta es la configuración predeterminada, que debes utilizar cuando emplees una cámara como fuente de vídeo.
getName
público Cadena getName()
El nombre de la transmisión. El nombre aparece en la parte inferior de los vídeos de los suscriptores.
Resultados: : nombre de la editorial
getPublishVideo
public boolean getPublishVideo()
Independientemente de si el editor publica vídeos (true) o no (
false).
getPublishAudio
public boolean getPublishAudio()
Independientemente de si la editorial publica contenido de audio (true) o no (
false).
getPublishCaptions
public boolean getPublishCaptions()
Si el editor publica subtítulos (true) o no (
false).
getSession
público Sesión getSession()
Devuelve el Session vinculado a esta instancia de Publisher.
Devoluciones:
: El Session vinculado a esta instancia de Publisher.
Véase también:
: - Session.publish(com.opentok.android.PublisherKit)
getStream
público Transmisión getStream()
Devuelve el objeto de flujo correspondiente al flujo del Publisher.
Devuelve: : El objeto de flujo.
getPublisherVideoType
público PublisherKit.PublisherKitVideoType getPublisherVideoType()
Devuelve el tipo de vídeo de este editor.
Véase también:
: - setPublisherVideoType(PublisherKitVideoType type)
getMaxVideoBitrate
public int getMaxVideoBitrate()
Obtiene la tasa de bits máxima del vídeo para la transmisión del editor, en bits por segundo.
Devuelve el límite máximo configurado actualmente. Si no se ha establecido ninguna tasa de bits manual, o si hay un ajuste preestablecido de tasa de bits activo, el valor es 0.
Valores que devuelve: : La tasa de bits máxima del vídeo en bits por segundo, o 0 si no se ha establecido o si se utiliza un preajuste.
Véase también:
: - setMaxVideoBitrate(int maxVideoBitrate)
setMaxVideoBitrate
public void setMaxVideoBitrate(int maxVideoBitrate)
Establece la tasa de bits máxima de vídeo para la transmisión de vídeo del editor, en bits por segundo.
Este método aplica un límite máximo explícito a la tasa de bits del vídeo del editor. Si se establece el valor en 0, se elimina cualquier límite manual y se vuelve al comportamiento predeterminado de tasa de bits adaptativa basado en los ajustes preestablecidos, sin ningún límite explícito.
Parámetros:
: maxVideoBitrate - La tasa de bits máxima del vídeo, en bits por segundo,
entre 5.000 y 10.000.000.
Véase también:
: - getMaxVideoBitrate()
- setVideoBitratePreset(VideoBitratePreset videoBitratePreset)
- Velocidad de bits máxima del editor
getVideoBitratePreset
público PublisherKit.VideoBitratePreset getVideoBitratePreset()
Obtiene el ajuste preestablecido de velocidad de bits de vídeo actualmente activo para la transmisión del editor.
Devuelve la estrategia predefinida que se está utilizando. Si se ha configurado manualmente una tasa de bits personalizada
utilizando setMaxVideoBitrate(int), este método devuelve
PublisherKit.VideoBitratePreset.VideoBitratePresetCustom.
Devoluciones:
: El activo PublisherKit.VideoBitratePreset.
Véase también:
: - setVideoBitratePreset(VideoBitratePreset videoBitratePreset)
setVideoBitratePreset
public void setVideoBitratePreset(PublisherKit.VideoBitratePreset (ajuste predefinido de velocidad de bits de vídeo)
Establece una estrategia predefinida de velocidad de bits de vídeo para la transmisión de vídeo del editor.
Las configuraciones predefinidas equilibran la calidad del vídeo y el uso del ancho de banda mediante estrategias predefinidas.
Las configuraciones predefinidas y los ajustes manuales de la tasa de bits son mutuamente excluyentes.
Configurar el setMaxVideoBitrate(int) Este método anula cualquier preajuste y
cambia automáticamente el preajuste activo a PublisherKit.VideoBitratePreset.VideoBitratePresetCustom.
Nota: El PublisherKit.VideoBitratePreset.VideoBitratePresetCustom No se puede establecer el valor directamente.
Parámetros:
: videoBitratePreset - El PublisherKit.VideoBitratePreset para presentar la solicitud.
Véase también:
: - getVideoBitratePreset()
- setMaxVideoBitrate(int maxVideoBitrate)
- Velocidad de bits máxima del editor
getDegradationPreference
público PublisherKit.PreferenciaDeDegradación getDegradationPreference()
Obtiene la política preferida que seguirá el motor de vídeo a la hora de ajustar la frecuencia de fotogramas y la resolución en función de
las limitaciones de ancho de banda y las condiciones de la CPU. Véase PublisherKit.DegradationPreference para ver una descripción de los valores posibles.
Devuelve: : La preferencia de degradación actual.
establecerPreferenciaDeDegradación
public void setDegradationPreference(PublisherKit.PreferenciaDeDegradación (preferencia de degradación)
Obtiene la política preferida que seguirá el motor de vídeo a la hora de ajustar la frecuencia de fotogramas y la resolución en función de
las limitaciones de ancho de banda y las condiciones de la CPU. Véase PublisherKit.DegradationPreference para ver una descripción de los valores posibles.
Parámetros:
: degradationPreference - La preferencia de degradación.
setTargetScalabilityMode
public void setTargetScalabilityMode(Cadena (modo de escalabilidad)
Establece el modo de escalabilidad deseado (SVC: codificación de vídeo escalable) para este editor. El modo de escalabilidad controla el número de capas espaciales (resolución) y temporales (frecuencia de fotogramas) que codifica WebRTC. El modo se aplica a la ruta de medios del enrutador de medios. Este método puede invocarse en cualquier momento; no es necesario que la negociación de la ruta multimedia haya finalizado. El modo se aplicará una vez que se haya establecido la ruta multimedia del Media Router. Si se negocia un códec distinto de SVC (VP8, H.264) en la ruta de medios del Media Router, se utiliza el modo aplicable más cercano: las capas espaciales se fijan en 1, conservando la dimensión temporal (por ejemplo, L2T2 → L1T2 cuando se negocia VP8). Esta es una función en fase beta.
Parámetros:
: scalabilityMode - El modo de escalabilidad deseado.
Lanzamientos:
: IllegalArgumentException - si el modo solicitado no es un modo de escalabilidad válido
(es decir, no es uno de los siguientes: L1T1, L1T2, L1T3, L2T1, L2T2, L2T3, L3T1, L3T2, L3T3).
getTargetScalabilityMode
público Cadena getTargetScalabilityMode()
Obtiene el modo de escalabilidad de destino que se ha establecido explícitamente mediante setTargetScalabilityMode. Devuelve el último valor pasado al método setter, o null si nunca se ha llamado al método setter. Esto refleja la intención del usuario, no el modo realmente aplicado (que puede diferir debido a un recurso alternativo dependiente del códec). Se trata de una función en fase beta.
Valores devueltos: : El modo de escalabilidad de destino establecido por el llamante, o `null` si no se ha establecido explícitamente.
setPublisherListener
public void setPublisherListener(PublisherKit.PublisherListener oyente)
Asigna un PublisherKit.PublisherListener a esta instancia de Publisher para supervisar los
cambios de estado.
Parámetros:
: listener - El PublisherKit.PublisherListener que supervisará esta instancia, o «null»
para desconectar un oyente.
setAudioLevelListener
public void setAudioLevelListener(PublisherKit.AudioLevelListener oyente)
Asigna un PublisherKit.AudioLevelListener a esta instancia de PublisherKit para supervisar
las actualizaciones del nivel de audio.
Parámetros:
: listener - El PublisherKit.AudioLevelListener que supervisará esta instancia. Establece
este valor en «null» para desconectar un oyente y dejar de supervisar los niveles de audio.
setRtcStatsReportListener
public void setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener oyente)
Establece el oyente del informe de estadísticas de RTC como suscriptor. Véase getRtcStatsReport().
Parámetros:
: listener - El PublisherKit.PublisherRtcStatsReportListener objeto.
setVideoTransformers
public void setVideoTransformers(ArrayList<PublisherKit.VideoTransformer> videoTransformers)
Establece una lista de transformadores de vídeo para el flujo de vídeo de este editor. Si la lista está vacía, al llamar a este método se restablecen los transformadores. La matriz puede estar compuesta por transformadores de vídeo de Vonage proporcionados por ml-library o por transformadores personalizados (véase esta guía para desarrolladores). Nota: Los transformadores multimedia no son compatibles con todos los dispositivos ni con todas las versiones de Android. Ver esta documentación.
Parámetros:
: videoTransformers - La lista de transformadores de vídeo, en el orden en que se aplicarán a la secuencia.
setVideoListener
public void setVideoListener(PublisherKit.VideoListener oyente)
Establece un PublisherKit.VideoListener objeto para supervisar cuándo el editor comienza
y deja de enviar vídeo.
Parámetros:
: listener - El PublisherKit.VideoListener instancia.
setAudioTransformers
public void setAudioTransformers(ArrayList<PublisherKit.AudioTransformer> audioTransformers)
Establece una lista de transformadores de audio para el flujo de audio de este editor. Si la lista está vacía, al llamar a este método se restablecen los transformadores. La matriz puede estar compuesta por transformadores de audio de Vonage proporcionados por ml-library o por transformadores personalizados (véase esta guía para desarrolladores). Nota: Los transformadores multimedia no son compatibles con todos los dispositivos ni con todas las versiones de Android. Ver esta documentación. .
Parámetros:
: audioTransformers - La lista de transformadores de audio, en el orden en que se aplicarán a la secuencia de datos.
setStyle
public void setStyle(Cadena clave, Cadena valor)
Establece un estilo para el renderizador de vídeo que utiliza este editor.
Por defecto, solo hay una clave de estilo predefinida:
BaseVideoRenderer.STYLE_VIDEO_SCALE. Puedes establecer un valor para esta
clave con el fin de 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. Si no configurás este estilo, la configuración por defecto esBaseVideoRenderer.STYLE_VIDEO_FIT.
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.
Establece el renderizador de vídeo para este editor.
Este método está obsoleto. En su lugar, llama a
el PublisherKit.Builder.renderer(BaseVideoRenderer renderer) método al
utilizar el Builder para crear la instancia de PublisherKit.
getRenderer
público BaseVideoRenderer getRenderer()
Devuelve el renderizador de vídeo de este editor.
getCapturer
público BaseVideoCapturer getCapturer()
Devuelve el capturador de vídeo que utiliza este editor.
setCapturer
@Obsoleto public void setCapturer(BaseVideoCapturer newCapturer)
En desuso.
Establece el capturador de vídeo para este editor.
Este método está obsoleto. En su lugar, llama a la función
PublisherKit.Builder.capturer(BaseVideoCapturer capturer) método al utilizar
el generador para crear la instancia de PublisherKit.
getView
public android.view.View getView()
Devuelve el objeto `android.view.View` que contiene el vídeo de `Publisher`.
setVideoStatsListener
public void setVideoStatsListener(PublisherKit.VideoStatsListener oyente)
Configura un oyente para las estadísticas de vídeo del editor. El objeto oyente implementa la interfaz
PublisherKit.VideoStatsListener.onVideoStats(PublisherKit publisher, PublisherKit.PublisherVideoStats[] stats) método y, opcionalmente, el
PublisherKit.VideoStatsListener.onVideoQualityChanged(PublisherKit, PublisherVideoStats, String) método.
Véase también:
: - setAudioStatsListener(AudioStatsListener listener)
setAudioStatsListener
public void setAudioStatsListener(PublisherKit.AudioStatsListener oyente)
Configura un oyente para las estadísticas de audio del editor. El objeto oyente implementa la interfaz
PublisherKit.AudioStatsListener.onAudioStats(PublisherKit publisher, PublisherKit.PublisherAudioStats[] 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 enviados
- Total de bytes de audio enviados
Véase también:
: - setVideoStatsListener(VideoStatsListener listener)
setMediaLinkStatsListener
public void setMediaLinkStatsListener(PublisherKit.MediaLinkStatsListener oyente)
Configura un oyente para las estadísticas de enlaces multimedia del editor. El objeto oyente implementa la interfaz
PublisherKit.MediaLinkStatsListener.onMediaLinkStats(PublisherKit, PublisherMediaLinkStats[])
y PublisherKit.MediaLinkStatsListener.onNetworkConditionChanged(PublisherKit, PublisherMediaLinkStats, String)
métodos.
Parámetros:
: listener - El PublisherKit.MediaLinkStatsListener instancia, o «null» para eliminarla.
Véase también:
: - setVideoStatsListener(VideoStatsListener listener)
- setAudioStatsListener(AudioStatsListener listener)
setMuteListener
public void setMuteListener(PublisherKit.MuteListener oyente)
Establece un PublisherKit.MuteListener objeto que permite supervisar cuándo un moderador obliga
a este editor a silenciar el audio.
Parámetros:
: listener - El PublisherKit.MuteListener instancia.
getRtcStatsReport
public void obtenerInformeDeEstadísticasRtc()
Obtiene el informe de estadísticas de RTC del editor. Se trata de una operación asíncrona.
Llama a la setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener listener)
método y, a continuación, implementar el
PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherKit.PublisherRtcStats[] stats)
método antes de llamar a este método. Cuando las estadísticas estén disponibles, la implementación
del PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherKit.PublisherRtcStats[] stats)
se llama el método.
Véase también setAudioStatsListener(PublisherKit.AudioStatsListener listener),
setVideoStatsListener(PublisherKit.VideoStatsListener listener), y
SubscriberKit.getRtcStatsReport().
onRtcStatsReport
protected void onRtcStatsReport(PublisherKit.PublisherRtcStats[] estadísticas)
Se invoca cuando el informe de estadísticas RTC del editor está disponible, en respuesta a una
llamada a getRtcStatsReport().
Si extiendes la clase PublisherKit, puedes sobrescribir este método en lugar de implementar el método onRtcStatsReport() de la interfaz PublisherKit.PublisherRtcStatsReportListener.
Véase también:
: - PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherRtcStats[] stats)
onStreamCreated
protected void onStreamCreated(Transmisión (flujo)
Se invoca cuando se crea el flujo del editor.
Si extiendes la clase PublisherKit, puedes sobrescribir este método en lugar del
onStreamCreated() método de la interfaz PublisherKit.PublisherListener
.
Parámetros:
: stream - El flujo que se crea.
onStreamDestroyed
protected void onStreamDestroyed(Transmisión (flujo)
Se invoca cuando se destruye el flujo del editor.
Si extiendes la clase PublisherKit, puedes sobrescribir este método en lugar del
onStreamDestroyed() método de la interfaz PublisherKit.PublisherListener
.
Parámetros:
: stream - El flujo que se destruye.
onError
protected void onError(OpentokError (error)
Se invoca cuando el editor falla.
Si extiendes la clase PublisherKit, puedes sobrescribir este método en lugar del
onError() método de la interfaz PublisherKit.PublisherListener
.
Parámetros:
: error - El error que ha activado esta función de devolución de llamada.
onAudioLevelUpdated
protected void onAudioLevelUpdated(float audioLevel)
Se invoca periódicamente para informar del nivel de audio del editor.
Parámetros:
: audioLevel - El nivel de audio, de 0 a 1,0. Ajusta este valor
de forma logarítmica para utilizarlo en una visualización de la interfaz de usuario
(como un medidor de volumen).
onMuteForced
protected void onMuteForced()
Se activa cuando un moderador ha obligado a este editor a silenciar el audio.
Si extiendes la clase PublisherKit, puedes sobrescribir este método en lugar del
onMuteForced() método de la interfaz PublisherKit.MuteListener
.
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 lo invoca cuando determina que ya no hay referencias al objeto PublisherKit.
Sobrescrituras:
: finalize en clase Object
Lanzamientos:
: Throwable
onStop
public void onStop()
Libera los recursos asociados al editor. Al llamar a este método, el editor
deja de capturar imágenes y, a continuación, libera la cámara. Para volver a utilizar el editor tras
llamar a este método, llama al onRestart() método.
onRestart
public void onRestart()
Reinicia los recursos del editor que se habían liberado anteriormente mediante la llamada a la función
onStop() método.