com.opentok.android.PublisherKit.Builder
com.opentok.android.Publisher.Builder
Classe de contenção: : Editora
classe pública estática Publisher.Builder estende PublisherKit.Builder
Usado para construir um Publisher objeto. Instancie um objeto Builder usando o
Publisher.Builder(Context context) construtor. Em seguida, chame os métodos do
Builder instância para adicionar configurações para o editor. (Observe que o
Publisher.Builder A classe herda métodos da PublisherKit.Builder
(classe.) Em seguida, chame o build() método, que retorna um Publisher objeto.
Use o Session.publish(PublisherKit publisher) método para iniciar a transmissão
do editor para uma sessão.
Resumo do Construtor
Construtores
Construtor
Descrição
Builder(android.content.Context context)
Instantania um Publisher.Builder objeto.
Resumo do método
Todos os métodosMétodos de instânciaMétodos concretos
Modificador e Tipo
Método
Descrição
Publisher.Builder
allowAudioCaptureWhileMuted(boolean allow)
Se estiver definido como “false”, o microfone será desligado automaticamente quando todos os participantes tiverem silenciado seu áudio.
Publisher.Builder
audioBitrate(int bitsPerSecond)
Define a taxa de bits desejada para o áudio publicado, em bits por segundo.
Publisher.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).
Publisher
build()
Retorna um novo Publisher instância com base no Publisher.Builder
configurações.
Publisher.Builder
capturer(BaseVideoCapturer capturer)
Define o capturador de vídeo a ser usado pelo editor.
Publisher.Builder
enableOpusDtx(boolean enable)
Se deve ser ativado Opus DTX (true) ou não (false, o padrão).
Publisher.Builder
frameRate(Publisher.CameraCaptureFrameRate frameRate)
Define a taxa de quadros desejada do vídeo publicado.
Publisher.Builder
name(String name)
Define o nome do vídeo publicado.
Publisher.Builder
preferredVideoCodecs(PublisherKit.PreferredVideoCodecs preferredVideoCodecs)
Publisher.Builder
publisherAudioFallbackEnabled(boolean enabled)
Se a transmissão utilizará o recurso de fallback de áudio do editor (true) ou não
(false).
Publisher.Builder
renderer(BaseVideoRenderer renderer)
Define o renderizador de vídeo a ser usado pelo editor.
Publisher.Builder
resolution(Publisher.CameraCaptureResolution resolution)
Define a resolução do vídeo publicado.
Publisher.Builder
scalableScreenshare(boolean enable)
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).
Publisher.Builder
senderStatsTrack(boolean allow)
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.
Publisher.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.
Publisher.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 Publisher.Builder objeto.
Detalhes do método
resolução
público Publisher.Builder resolução(Publisher.CameraCaptureResolution (resolução)
Define a resolução do vídeo publicado. Defina esse valor de acordo com o definido no
Publisher.CameraCaptureResolution enum
taxa de quadros
público Publisher.Builder frameRate(Publisher.CameraCaptureFrameRate frameRate)
Define a taxa de quadros desejada do vídeo publicado. Defina esse valor conforme especificado em
o Publisher.CameraCaptureFrameRate enum. Se o dispositivo não for compatível com a
taxa de quadros especificada, ele utilizará a taxa de quadros compatível mais próxima. Observe que,
em sessões que utilizam o OpenTok Media Router (sessões com o modo de mídia definido como
“routed”), diminuir a taxa de quadros reduz proporcionalmente a largura de banda utilizada pela transmissão.
No entanto, em sessões cujo modo de mídia está definido como “relayed”, a redução da taxa de quadros
não reduz a largura de banda da transmissão. (Consulte
O OpenTok Media Router e os modos de mídia.)
nome
público Publisher.Builder nome(String nome)
Descrição copiada da aula: PublisherKit.Builder
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).
Substituições:
: name na aula PublisherKit.Builder
faixa de áudio
público Publisher.Builder audioTrack(boolean enabled)
Descrição copiada da aula: PublisherKit.Builder
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.
Substituições:
: audioTrack na aula PublisherKit.Builder
videoTrack
público Publisher.Builder videoTrack(booleano enabled)
Descrição copiada da aula: PublisherKit.Builder
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.
Substituições:
: videoTrack na aula PublisherKit.Builder
capturador
público Publisher.Builder capturador(BaseVideoCapturer capturador)
Define o capturador de vídeo a ser usado pelo publisher. Se você não chamar esse método, o publisher utilizará o capturador padrão do Publisher.
Substituições:
: capturer na aula PublisherKit.Builder
renderizador
público Publisher.Builder renderizador(BaseVideoRenderer renderizador)
Define o renderizador de vídeo a ser usado pelo publisher. Se você não chamar esse método, o publisher utilizará o renderizador padrão do Publisher.
Substituições:
: renderer na aula PublisherKit.Builder
taxa de bits de áudio
público Publisher.Builder audioBitrate(int bitsPorSegundo)
Descrição copiada da aula: PublisherKit.Builder
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.
Substituições:
: audioBitrate na aula PublisherKit.Builder
Parâmetros:
: bitsPerSecond - A taxa de bits desejada para o áudio, em bits por segundo.
Retorna: : Este objeto Builder.
compartilhamento de tela escalável
público Publisher.Builder scalableScreenshare(boolean enable)
Descrição copiada da aula: PublisherKit.Builder
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).
Substituições:
: scalableScreenshare na aula PublisherKit.Builder
ativarOpusDtx
público Publisher.Builder enableOpusDtx(boolean enable)
Descrição copiada da aula: PublisherKit.Builder
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.
Substituições:
: enableOpusDtx na aula PublisherKit.Builder
subscriberAudioFallbackEnabled
público Publisher.Builder subscriberAudioFallbackEnabled(boolean enabled)
Descrição copiada da aula: PublisherKit.Builder
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.
Substituições:
: subscriberAudioFallbackEnabled na aula PublisherKit.Builder
Veja também:
: - SubscriberKit.VideoListener.onVideoDisabled(SubscriberKit subscriber, String reason)
- o
OpenTok Media Router e os modos de mídia
publisherAudioFallbackEnabled
público Publisher.Builder publisherAudioFallbackEnabled(boolean enabled)
Descrição copiada da aula: PublisherKit.Builder
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).
Substituições:
: publisherAudioFallbackEnabled na aula PublisherKit.Builder
Veja também:
: - PublisherKit.VideoListener.onVideoDisabled(PublisherKit publisher, String reason)
- o
OpenTok Media Router e os modos de mídia
permitirCapturaDeÁudioEnquantoSilenciado
público Publisher.Builder allowAudioCaptureWhileMuted(boolean allow)
Descrição copiada da aula: PublisherKit.Builder
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.
Substituições:
: allowAudioCaptureWhileMuted na aula PublisherKit.Builder
codecs de vídeo preferidos
público Publisher.Builder preferredVideoCodecs(PublisherKit.Codecs de vídeo preferenciais (preferredVideoCodecs)
Substituições:
: preferredVideoCodecs na aula PublisherKit.Builder
senderStatsTrack
público Publisher.Builder senderStatsTrack(boolean allow)
Descrição copiada da aula: PublisherKit.Builder
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.
Substituições:
: senderStatsTrack na aula PublisherKit.Builder
construir
público Editora build()
Retorna um novo Publisher instância com base no Publisher.Builder
configurações.
Substituições:
: build na aula PublisherKit.Builder
Retorna:
: Retorna um novo PublisherKit instância com base no PublisherKit.Builder
configurações.