com.opentok.android.PublisherKit.Builder
com.opentok.android.Publisher.Builder
Clase contenedora: : Editorial
clase pública estática Publisher.Builder extende PublisherKit.Builder
Se utiliza para crear un Publisher objeto. Crea una instancia de un objeto Builder utilizando el
Publisher.Builder(Context context) constructor. A continuación, llama a los métodos del
Builder instancia para añadir la configuración del editor. (Ten en cuenta que el
Publisher.Builder La clase hereda métodos de la PublisherKit.Builder
(clase). A continuación, llama a la build() método, que devuelve un Publisher objeto.
Utiliza el Session.publish(PublisherKit publisher) método para iniciar la transmisión
desde el editor a una sesión.
Resumen del constructor
Constructores
Constructor
Descripción
Builder(android.content.Context context)
Crea una instancia de un Publisher.Builder objeto.
Resumen del método
Todos los métodosMétodos de instanciaMétodos concretos
Modificador y tipo
Método
Descripción
Publisher.Builder
allowAudioCaptureWhileMuted(boolean allow)
Si se establece en «false», el micrófono se apagará automáticamente cuando todos los emisores hayan silenciado su audio.
Publisher.Builder
audioBitrate(int bitsPerSecond)
Establece la tasa de bits deseada para el audio publicado, en bits por segundo.
Publisher.Builder
audioTrack(boolean enabled)
Establece si se debe incluir una pista de audio en la transmisión publicada (true,
el valor por defecto) o no (false).
Publisher
build()
Devuelve un nuevo Publisher por ejemplo, basándose en el Publisher.Builder
configuración.
Publisher.Builder
capturer(BaseVideoCapturer capturer)
Establece el capturador de vídeo que se va a utilizar para el editor.
Publisher.Builder
enableOpusDtx(boolean enable)
Si se debe activar Opus DTX (true) o no (false, el valor por defecto).
Publisher.Builder
frameRate(Publisher.CameraCaptureFrameRate frameRate)
Establece la velocidad de fotogramas deseada del vídeo publicado.
Publisher.Builder
name(String name)
Establece el nombre del vídeo publicado.
Publisher.Builder
preferredVideoCodecs(PublisherKit.PreferredVideoCodecs preferredVideoCodecs)
Publisher.Builder
publisherAudioFallbackEnabled(boolean enabled)
Si la transmisión utilizará la función de audio de reserva del editor (true) o no
(false).
Publisher.Builder
renderer(BaseVideoRenderer renderer)
Establece el renderizador de vídeo que se utilizará para el editor.
Publisher.Builder
resolution(Publisher.CameraCaptureResolution resolution)
Establece la resolución del vídeo publicado.
Publisher.Builder
scalableScreenshare(boolean enable)
Si se debe permitir el uso de vídeo escalable para un editor cuyo «videoType» esté establecido en «PublisherKitVideoTypeScreen» (true) o no (false, el valor por defecto).
Publisher.Builder
senderStatsTrack(boolean allow)
Si no llamas a esta función y le pasas true, el subsistema de estadísticas del remitente no se
inicializará para el editor.
Publisher.Builder
subscriberAudioFallbackEnabled(boolean enabled)
Si la transmisión utilizará la función de audio de reserva para los suscriptores (true) o no
(false), para los suscriptores del canal publicado.
Publisher.Builder
videoTrack(boolean enabled)
Establece si se debe incluir una pista de vídeo en la transmisión publicada (true,
el valor por defecto) o no (false).
Métodos heredados de la clase java.lang.Objeto
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Datos del constructor
Constructor
public Builder(android.content.Context context)
Crea una instancia de un Publisher.Builder objeto.
Detalles del método
resolución
público Publisher.Builder resolución(Publisher.CameraCaptureResolution (resolución)
Establece la resolución del vídeo publicado. Establece este valor en uno de los definidos en el
Publisher.CameraCaptureResolution enum
frecuencia de fotogramas
público Publisher.Builder frameRate(Publisher.CameraCaptureFrameRate frameRate)
Establece la velocidad de fotogramas deseada del vídeo publicado. Establece este valor en uno de los definidos en
el Publisher.CameraCaptureFrameRate enum. Si el dispositivo no admite la
frecuencia de fotogramas especificada, utilizará la frecuencia de fotogramas más cercana que admita. Ten en cuenta que,
en las sesiones que utilizan el OpenTok Media Router (sesiones con el modo multimedia configurado en
«routed»), reducir la frecuencia de fotogramas reduce proporcionalmente el ancho de banda que consume la transmisión.
Sin embargo, en las sesiones cuyo modo multimedia esté configurado en «relayed», reducir la frecuencia de fotogramas
no reduce el ancho de banda de la transmisión. (Véase
El OpenTok Media Router y los modos multimedia.)
nombre
público Publisher.Builder nombre(Cadena nombre)
Descripción copiada de la clase: PublisherKit.Builder
Establece el nombre del vídeo publicado. El name La propiedad de una transmisión
publicada por este editor se establecerá en este valor (en todos los clientes).
Sobrescrituras:
: name en clase PublisherKit.Builder
pista de audio
público Publisher.Builder audioTrack(booleano enabled)
Descripción copiada de la clase: PublisherKit.Builder
Establece si se debe incluir una pista de audio en la transmisión publicada (true,
el valor por defecto) o no (false). Crear un editor sin pista de audio
puede ahorrar recursos de la CPU y reducir el ancho de banda que consume la transmisión.
Si llamas a esta función y le pasas false, el subsistema de audio no se
inicializará para el editor, y al llamar a la función
PublisherKit.setPublishAudio(boolean publishAudio) El método no tendrá ningún efecto.
Si tu aplicación no requiere el uso de audio, se recomienda utilizar esta
configuración del Builder en lugar de utilizar el
PublisherKit.setPublishAudio(boolean publishAudio) método, que solo
desactiva temporalmente la pista de audio.
Sobrescrituras:
: audioTrack en clase PublisherKit.Builder
videoTrack
público Publisher.Builder videoTrack(booleano enabled)
Descripción copiada de la clase: PublisherKit.Builder
Establece si se debe incluir una pista de vídeo en la transmisión publicada (true,
el valor por defecto) o no (false). Crear un editor sin pista de vídeo
puede ahorrar recursos de la CPU y reducir el ancho de banda que consume la transmisión.
Si llamas a esta función y le pasas false, el subsistema de vídeo no se
inicializará para el editor, y al llamar a la función
PublisherKit.setPublishVideo(boolean publishVideo) El método no tendrá ningún efecto.
Si tu aplicación no requiere el uso de vídeo, se recomienda utilizar esta
configuración del Builder en lugar de utilizar el
PublisherKit.setPublishVideo(boolean publishVideo) método, que solo
desactiva temporalmente la pista de vídeo.
Sobrescrituras:
: videoTrack en clase PublisherKit.Builder
capturador
público Publisher.Builder capturador(BaseVideoCapturer capturador)
Establece el capturador de vídeo que debe utilizar el editor. Si no se invoca este método, el editor utilizará el capturador predeterminado del editor.
Sobrescrituras:
: capturer en clase PublisherKit.Builder
motor de renderizado
público Publisher.Builder renderizador(BaseVideoRenderer renderizador)
Establece el renderizador de vídeo que se utilizará para el editor. Si no se invoca este método, el editor utilizará el renderizador predeterminado del editor.
Sobrescrituras:
: renderer en clase PublisherKit.Builder
velocidad de bits de audio
público Publisher.Builder audioBitrate(int bitsPorSegundo)
Descripción copiada de la clase: PublisherKit.Builder
Establece la tasa de bits deseada para el audio publicado, en bits por segundo. El rango de valores admitido es de 6.000 a 510.000. (Los valores no válidos se ignoran.) Establece este valor para activar el audio de alta calidad (o para reducir el consumo de ancho de banda con audio de menor calidad).
A continuación se indican los ajustes recomendados:
- 8.000 - 12.000 para voz de banda estrecha (NB)
- 16.000 - 20.000 para voz de banda ancha (WB)
- Entre 28 000 y 40 000 para la voz en banda completa (FB)
- Entre 48 000 y 64 000 para música en mono de banda completa (FB)
- 64 000 - 128 000 para música en estéreo de banda completa (FB)
El valor por defecto es 40 000.
Para configurar otros ajustes de audio, consulta la AudioDeviceManager clase.
Sobrescrituras:
: audioBitrate en clase PublisherKit.Builder
Parámetros:
: bitsPerSecond - La tasa de bits deseada del audio, en bits por segundo.
Devuelve: : Este objeto Builder.
scalableScreenshare
público Publisher.Builder scalableScreenshare(boolean enable)
Descripción copiada de la clase: PublisherKit.Builder
Si se debe permitir el uso de vídeo escalable para un editor cuyo «videoType» esté establecido en «PublisherKitVideoTypeScreen» (true) o no (false, el valor por defecto).
Sobrescrituras:
: scalableScreenshare en clase PublisherKit.Builder
activarOpusDtx
público Publisher.Builder enableOpusDtx(booleano enable)
Descripción copiada de la clase: PublisherKit.Builder
Si se debe activar Opus DTX (true) o no (false, que es la opción predeterminada). Al activar Opus DTX
se puede reducir el consumo de ancho de banda en las transmisiones que presentan largos periodos de silencio.
Por defecto, Opus DTX está desactivado. Si esta propiedad se establece en true,
Se activará Opus DTX para la editorial.
Sobrescrituras:
: enableOpusDtx en clase PublisherKit.Builder
subscriberAudioFallbackEnabled
público Publisher.Builder subscriberAudioFallbackEnabled(boolean enabled)
Descripción copiada de la clase: PublisherKit.Builder
Si la transmisión utilizará la función de audio de reserva para los suscriptores (true) o no
(false), para los suscriptores de la transmisión publicada. La función de recambio de audio para suscriptores
está disponible en las sesiones que utilizan el OpenTok Media Router. Con la
función de recambio de audio para suscriptores activada (por defecto), cuando el OpenTok Media Router determina que la
calidad de una transmisión se ha degradado significativamente para un suscriptor concreto, desactiva el vídeo
de dicho suscriptor con el fin de preservar la calidad del audio.
La configuración predeterminada es true (la función de recambio de audio está activada).
Cuando se utiliza el tipo de vídeo de pantalla en una sesión que emplea el servidor multimedia OpenTok, la
configuración de recambio de audio del suscriptor está establecida en false por defecto,
para que el vídeo no se corte a los suscriptores.
Sobrescrituras:
: subscriberAudioFallbackEnabled en clase PublisherKit.Builder
Véase también:
: - SubscriberKit.VideoListener.onVideoDisabled(SubscriberKit subscriber, String reason)
- El
OpenTok Media Router y los modos multimedia
publisherAudioFallbackEnabled
público Publisher.Builder publisherAudioFallbackEnabled(boolean enabled)
Descripción copiada de la clase: PublisherKit.Builder
Si la transmisión utilizará la función de audio de reserva del editor (true) o no
(false). Cuando la función de recambio de audio del editor está activada (por defecto), si
el editor detecta que la calidad de una transmisión se ha degradado significativamente, desactiva el vídeo
para preservar la calidad del audio.
La configuración predeterminada es false (la función de audio alternativo está desactivada).
Sobrescrituras:
: publisherAudioFallbackEnabled en clase PublisherKit.Builder
Véase también:
: - PublisherKit.VideoListener.onVideoDisabled(PublisherKit publisher, String reason)
- El
OpenTok Media Router y los modos multimedia
permitir la captura de audio con el sonido silenciado
público Publisher.Builder allowAudioCaptureWhileMuted(boolean allow)
Descripción copiada de la clase: PublisherKit.Builder
Si se establece en «false», el micrófono se apagará automáticamente cuando todos los emisores hayan silenciado su audio. El micrófono se volverá a encender automáticamente cuando al menos un emisor active el audio. Si se establece en «true», el micrófono permanecerá siempre encendido, incluso cuando todos los emisores hayan silenciado su audio. Ten en cuenta que, cuando el micrófono está desactivado, las funciones de devolución de llamada como «AudioLevel» o «AudioData» ya no se invocarán para los emisores. El valor por defecto es «false».
Sobrescrituras:
: allowAudioCaptureWhileMuted en clase PublisherKit.Builder
códecs de vídeo preferidos
público Publisher.Builder preferredVideoCodecs(PublisherKit.Códecs de vídeo preferidos (códecs de vídeo preferidos)
Sobrescrituras:
: preferredVideoCodecs en clase PublisherKit.Builder
senderStatsTrack
público Publisher.Builder senderStatsTrack(boolean allow)
Descripción copiada de la clase: PublisherKit.Builder
Si no llamas a esta función y le pasas true, el subsistema de estadísticas del remitente no se
inicializará para el editor.
Sobrescrituras:
: senderStatsTrack en clase PublisherKit.Builder
construir
público Editorial build()
Devuelve un nuevo Publisher por ejemplo, basándose en el Publisher.Builder
configuración.
Sobrescrituras:
: build en clase PublisherKit.Builder
Devuelve:
: Devuelve un nuevo PublisherKit por ejemplo, basándose en el PublisherKit.Builder
configuración.