com.opentok.android.PublisherKit.Builder
Subclases conocidas directas:
: Publisher.Builder
Clase contenedora: : PublisherKit
clase pública estática PublisherKit.Builder extende Objeto
Se utiliza para crear un PublisherKit objeto. Crea una instancia de un objeto Builder utilizando el
PublisherKit.Builder(Context context) constructor. A continuación, llama a los métodos de
el Builder instancia para añadir la configuración del editor. A continuación, llama a la
build() método, que devuelve un PublisherKit objeto.
Utiliza el Session.publish(PublisherKit publisher) método para iniciar la transmisión
desde el editor a una sesión.
Los «publishers» no se pueden reutilizar. Crea una nueva instancia de PublisherKit objeto cada vez que
quieras publicar una nueva transmisión.
Véase también:
: - PublisherKit.setPublisherListener(PublisherKit.PublisherListener listener)
Resumen del constructor
Constructores
Constructor
Descripción
Builder(android.content.Context context)
Crea una instancia de un PublisherKit.Builder objeto.
Resumen del método
Todos los métodosMétodos de instanciaMétodos concretos
Modificador y tipo
Método
Descripción
PublisherKit.Builder
allowAudioCaptureWhileMuted(boolean allow)
Si se establece en «false», el micrófono se apagará automáticamente cuando todos los emisores hayan silenciado su audio.
PublisherKit.Builder
audioBitrate(int bitsPerSecond)
Establece la tasa de bits deseada para el audio publicado, en bits por segundo.
PublisherKit.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).
PublisherKit
build()
PublisherKit.Builder
capturer(BaseVideoCapturer capturer)
Establece el capturador de vídeo que se va a utilizar para el editor.
PublisherKit.Builder
enableOpusDtx(boolean enable)
Si se debe activar Opus DTX (true) o no (false, el valor por defecto).
PublisherKit.Builder
name(String name)
Establece el nombre del vídeo publicado.
PublisherKit.Builder
preferredVideoCodecs(PublisherKit.PreferredVideoCodecs preferredVideoCodecs)
PublisherKit.Builder
publisherAudioFallbackEnabled(boolean enabled)
Si la transmisión utilizará la función de audio de reserva del editor (true) o no
(false).
PublisherKit.Builder
renderer(BaseVideoRenderer renderer)
Establece el renderizador de vídeo que se utilizará para el editor.
PublisherKit.Builder
scalableScreenshare(boolean enabled)
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).
PublisherKit.Builder
senderStatsTrack(boolean enabled)
Si no llamas a esta función y le pasas true, el subsistema de estadísticas del remitente no se
inicializará para el editor.
PublisherKit.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.
PublisherKit.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 PublisherKit.Builder objeto.
Parámetros:
: context - El android.content.Context para la editorial.
Detalles del método
nombre
público PublisherKit.Builder nombre(Cadena nombre)
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).
pista de audio
público PublisherKit.Builder audioTrack(booleano enabled)
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.
videoTrack
público PublisherKit.Builder videoTrack(booleano enabled)
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.
capturador
público PublisherKit.Builder capturador(BaseVideoCapturer capturador)
Establece el capturador de vídeo que se va a utilizar para el editor.
motor de renderizado
público PublisherKit.Builder renderizador(BaseVideoRenderer renderizador)
Establece el renderizador de vídeo que se utilizará para el editor.
velocidad de bits de audio
público PublisherKit.Builder audioBitrate(int bitsPorSegundo)
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.
Parámetros:
: bitsPerSecond - La tasa de bits deseada del audio, en bits por segundo.
Devuelve: : Este objeto Builder.
activarOpusDtx
público PublisherKit.Builder enableOpusDtx(booleano enable)
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.
scalableScreenshare
público PublisherKit.Builder scalableScreenshare(boolean enabled)
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).
subscriberAudioFallbackEnabled
público PublisherKit.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 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.
Véase también:
: - SubscriberKit.VideoListener.onVideoDisabled(SubscriberKit subscriber, String reason)
- El
OpenTok Media Router y los modos multimedia
publisherAudioFallbackEnabled
público PublisherKit.Builder publisherAudioFallbackEnabled(boolean enabled)
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).
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 PublisherKit.Builder allowAudioCaptureWhileMuted(boolean allow)
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».
códecs de vídeo preferidos
público PublisherKit.Builder preferredVideoCodecs(PublisherKit.Códecs de vídeo preferidos (códecs de vídeo preferidos)
senderStatsTrack
público PublisherKit.Builder senderStatsTrack(boolean enabled)
Si no llamas a esta función y le pasas true, el subsistema de estadísticas del remitente no se
inicializará para el editor.
construir
público PublisherKit build()
Devuelve:
: Devuelve un nuevo PublisherKit por ejemplo, basándose en el PublisherKit.Builder
configuración.