com.opentok.android.PublisherKit.Builder
Subclasses diretas conhecidas:
: Publisher.Builder
Classe de contenção: : PublisherKit
classe pública estática PublisherKit.Builder estende Objeto
Usado para construir um PublisherKit objeto. Instancie um objeto Builder usando o
PublisherKit.Builder(Context context) construtor. Em seguida, chame os métodos de
o Builder instância para adicionar configurações para o editor. Em seguida, chame o
build() método, que retorna um PublisherKit objeto.
Use o Session.publish(PublisherKit publisher) método para iniciar a transmissão
do editor para uma sessão.
Os Publishers não podem ser reutilizados. Instancie um novo PublisherKit objeto sempre que você
quiser publicar um novo stream.
Veja também:
: - PublisherKit.setPublisherListener(PublisherKit.PublisherListener listener)
Resumo do Construtor
Construtores
Construtor
Descrição
Builder(android.content.Context context)
Instantania um PublisherKit.Builder objeto.
Resumo do método
Todos os métodosMétodos de instânciaMétodos concretos
Modificador e Tipo
Método
Descrição
PublisherKit.Builder
allowAudioCaptureWhileMuted(boolean allow)
Se estiver definido como “false”, o microfone será desligado automaticamente quando todos os participantes tiverem silenciado seu áudio.
PublisherKit.Builder
audioBitrate(int bitsPerSecond)
Define a taxa de bits desejada para o áudio publicado, em bits por segundo.
PublisherKit.Builder
audioTrack(boolean enabled)
Determina se uma trilha de áudio deve ser incluída na transmissão publicada (true,
(padrão) ou não (false).
PublisherKit
build()
PublisherKit.Builder
capturer(BaseVideoCapturer capturer)
Define o capturador de vídeo a ser usado pelo editor.
PublisherKit.Builder
enableOpusDtx(boolean enable)
Se deve ser ativado Opus DTX (true) ou não (false, o padrão).
PublisherKit.Builder
name(String name)
Define o nome do vídeo publicado.
PublisherKit.Builder
preferredVideoCodecs(PublisherKit.PreferredVideoCodecs preferredVideoCodecs)
PublisherKit.Builder
publisherAudioFallbackEnabled(boolean enabled)
Se a transmissão utilizará o recurso de fallback de áudio do editor (true) ou não
(false).
PublisherKit.Builder
renderer(BaseVideoRenderer renderer)
Define o renderizador de vídeo a ser usado pelo editor.
PublisherKit.Builder
scalableScreenshare(boolean enabled)
Se deve permitir o uso de vídeo escalável para um publisher cujo vídeoType esteja definido como PublisherKitVideoTypeScreen (true) ou não (false, o padrão).
PublisherKit.Builder
senderStatsTrack(boolean enabled)
Se você não chamar essa função e passar true, o subsistema de estatísticas do remetente não será
inicializado para o editor.
PublisherKit.Builder
subscriberAudioFallbackEnabled(boolean enabled)
Se a transmissão utilizará o recurso de fallback de áudio do assinante (true) ou não
(false), para os assinantes do feed publicado.
PublisherKit.Builder
videoTrack(boolean enabled)
Determina se uma trilha de vídeo deve ser incluída na transmissão publicada (true,
(padrão) ou não (false).
Métodos herdados da classe java.lang.Objeto
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Detalhes do construtor
Construtor
public Builder(android.content.Context context)
Instantania um PublisherKit.Builder objeto.
Parâmetros:
: context - O android.content.Context para a editora.
Detalhes do método
nome
público PublisherKit.Builder nome(String nome)
Define o nome do vídeo publicado. O name A propriedade de um stream
publicado por esse editor será definida com esse valor (em todos os clientes).
faixa de áudio
público PublisherKit.Builder audioTrack(boolean enabled)
Determina se uma trilha de áudio deve ser incluída na transmissão publicada (true,
(padrão) ou não (false). Criar um publisher sem uma faixa de áudio
pode economizar recursos da CPU e reduzir a largura de banda utilizada pela transmissão.
Se você chamar essa função e passar false, o subsistema de áudio não será
inicializado para o editor, e a chamada à função
PublisherKit.setPublishAudio(boolean publishAudio) O método não terá efeito.
Se o seu aplicativo não exigir o uso de áudio, recomenda-se utilizar essa
configuração do Builder em vez de usar o
PublisherKit.setPublishAudio(boolean publishAudio) método, que apenas
desativa temporariamente a trilha de áudio.
videoTrack
público PublisherKit.Builder videoTrack(booleano enabled)
Determina se uma trilha de vídeo deve ser incluída na transmissão publicada (true,
(padrão) ou não (false). Criar um publisher sem uma trilha de vídeo
pode economizar recursos da CPU e reduzir a largura de banda utilizada pela transmissão.
Se você chamar essa função e passar false, o subsistema de vídeo não será
inicializado para o editor, e chamar a função
PublisherKit.setPublishVideo(boolean publishVideo) O método não terá efeito.
Se o seu aplicativo não exigir o uso de vídeo, recomenda-se utilizar essa
configuração do Builder em vez de usar o
PublisherKit.setPublishVideo(boolean publishVideo) método, que apenas
desativa temporariamente a trilha de vídeo.
capturador
público PublisherKit.Builder capturador(BaseVideoCapturer capturador)
Define o capturador de vídeo a ser usado pelo editor.
renderizador
público PublisherKit.Builder renderizador(BaseVideoRenderer renderizador)
Define o renderizador de vídeo a ser usado pelo editor.
taxa de bits de áudio
público PublisherKit.Builder audioBitrate(int bitsPorSegundo)
Define a taxa de bits desejada para o áudio publicado, em bits por segundo. O intervalo de valores suportado é de 6.000 a 510.000. (Valores inválidos são ignorados.) Defina esse valor para ativar o áudio de alta qualidade (ou para reduzir o uso de largura de banda com áudio de qualidade inferior).
A seguir, apresentamos as configurações recomendadas:
- 8.000 – 12.000 para voz em banda estreita (NB)
- 16.000 – 20.000 para fala em banda larga (WB)
- 28.000 – 40.000 para fala em banda completa (FB)
- 48.000 – 64.000 para música mono em banda completa (FB)
- 64.000 – 128.000 para música estéreo em banda completa (FB)
O valor padrão é 40.000.
Para definir outras configurações de áudio, consulte o AudioDeviceManager classe.
Parâmetros:
: bitsPerSecond - A taxa de bits desejada para o áudio, em bits por segundo.
Retorna: : Este objeto Builder.
ativarOpusDtx
público PublisherKit.Builder enableOpusDtx(boolean enable)
Se deve ser ativado Opus DTX (true) ou não (false, (padrão). Ativar o Opus DTX
pode reduzir o uso de largura de banda em transmissões que apresentam longos períodos de silêncio.
Por padrão, o Opus DTX está desativado. Se essa propriedade estiver definida como true,
O Opus DTX será ativado para a editora.
compartilhamento de tela escalável
público PublisherKit.Builder scalableScreenshare(boolean enabled)
Se deve permitir o uso de vídeo escalável para um publisher cujo vídeoType esteja definido como PublisherKitVideoTypeScreen (true) ou não (false, o padrão).
subscriberAudioFallbackEnabled
público PublisherKit.Builder subscriberAudioFallbackEnabled(boolean enabled)
Se a transmissão utilizará o recurso de fallback de áudio do assinante (true) ou não
(false), para assinantes do fluxo publicado. O recurso de fallback de áudio do assinante
está disponível em sessões que utilizam o OpenTok Media Router. Com o recurso de
fallback de áudio para assinantes ativado (configuração padrão), quando o OpenTok Media Router determina que a
qualidade de uma transmissão se deteriorou significativamente para um assinante específico, ele desativa o vídeo
para esse assinante a fim de preservar a qualidade do áudio.
A configuração padrão é true (o recurso de fallback de áudio está ativado).
Ao utilizar o tipo de vídeo de tela em uma sessão que utiliza o OpenTok Media Server, a
configuração de fallback de áudio do assinante está definida como false por padrão,
para que o vídeo não pare de ser exibido para os inscritos.
Veja também:
: - SubscriberKit.VideoListener.onVideoDisabled(SubscriberKit subscriber, String reason)
- o
OpenTok Media Router e os modos de mídia
publisherAudioFallbackEnabled
público PublisherKit.Builder publisherAudioFallbackEnabled(boolean enabled)
Se a transmissão utilizará o recurso de fallback de áudio do editor (true) ou não
(false). Com o recurso de fallback de áudio do publisher ativado (configuração padrão), quando
o publisher detecta que a qualidade de um stream se deteriorou significativamente, ele desativa o vídeo
para preservar a qualidade do áudio.
A configuração padrão é false (o recurso de alternância de áudio está desativado).
Veja também:
: - PublisherKit.VideoListener.onVideoDisabled(PublisherKit publisher, String reason)
- o
OpenTok Media Router e os modos de mídia
permitirCapturaDeÁudioEnquantoSilenciado
público PublisherKit.Builder allowAudioCaptureWhileMuted(boolean allow)
Se definido como false, o microfone será desligado automaticamente quando todos os emissores tiverem silenciado seu áudio. O microfone será ligado automaticamente novamente quando pelo menos um emissor desativar o silenciamento do áudio. Se definido como true, o microfone permanecerá sempre ligado, mesmo quando todos os emissores tiverem silenciado seu áudio. Esteja ciente de que, quando o microfone estiver desligado, callbacks como AudioLevel ou AudioData não serão mais invocados para os emissores. O valor padrão é false.
codecs de vídeo preferidos
público PublisherKit.Builder preferredVideoCodecs(PublisherKit.Codecs de vídeo preferenciais (preferredVideoCodecs)
senderStatsTrack
público PublisherKit.Builder senderStatsTrack(boolean enabled)
Se você não chamar essa função e passar true, o subsistema de estatísticas do remetente não será
inicializado para o editor.
construir
público PublisherKit build()
Retorna:
: Retorna um novo PublisherKit instância com base no PublisherKit.Builder
configurações.