com.opentok.android.PublisherKit
Todas as interfaces implementadas:
: Observer
Subclasses diretas conhecidas:
: Publisher
classe pública PublisherKit estende Objeto implementa Observador
Um publisher captura um fluxo de áudio e vídeo das fontes que você especificar. Você
pode, então, publicar o fluxo de áudio e vídeo em uma sessão do OpenTok chamando o
Session.publish(PublisherKit publisher) método.
Crie uma subclasse do PublisherKit caso tenha interesse em fornecer sua própria
implementação de captura e renderização de vídeo. Caso contrário, use o Publisher
classe, que inclui um capturador e um renderizador de vídeo já integrados.
Resumo das classes aninhadas
Classes aninhadas
Modificador e Tipo
Classe
Descrição
static interface
PublisherKit.AudioLevelListener
Monitora as variações no nível de áudio do emissor.
static interface
PublisherKit.AudioStatsListener
Define o objeto ouvinte para obter estatísticas de áudio do emissor.
class
PublisherKit.AudioTransformer
Um transformador para um fluxo de áudio.
static class
PublisherKit.Builder
Usado para construir um PublisherKit objeto.
static interface
PublisherKit.CustomAudioTransformer
Define um transformador personalizado para um fluxo de áudio, a ser passado para o
PublisherKit.AudioTransformer
construtor.
static interface
PublisherKit.CustomVideoTransformer
Define um transformador personalizado para um fluxo de vídeo, a ser passado para o
PublisherKit.VideoTransformer
construtor.
static enum
PublisherKit.DegradationPreference
Descreve a política que o mecanismo de vídeo tentará seguir ao adaptar a taxa de quadros e a resolução a largura de banda e CPU limitadas.
static interface
PublisherKit.MediaLinkStatsListener
Define o objeto ouvinte para obter estatísticas de links de mídia do editor.
static interface
PublisherKit.MuteListener
Monitora quando um moderador força esse criador de conteúdo a silenciar o áudio.
static final class
PublisherKit.PreferredVideoCodecs
Define as preferências de codec para a publicação de vídeos.
static class
PublisherKit.PublisherAudioStats
Define as estatísticas de áudio de um editor.
static enum
PublisherKit.PublisherKitVideoType
Define valores para o setPublisherVideoType(PublisherKitVideoType type) método.
static interface
PublisherKit.PublisherListener
Monitora quando um editor inicia e encerra a transmissão para a sessão.
static class
PublisherKit.PublisherMediaLinkStats
Fornece estatísticas de links de mídia dos editores, incluindo métricas de transporte local.
static class
PublisherKit.PublisherRtcStats
Representa as estatísticas de RTC de um fluxo de mídia publicado pelo editor.
static interface
PublisherKit.PublisherRtcStatsReportListener
Define o objeto ouvinte para receber relatórios de estatísticas RTC do editor.
static class
PublisherKit.PublisherVideoStats
Define as estatísticas de vídeo para um editor.
static enum
PublisherKit.VideoBitratePreset
Define valores para o setVideoBitratePreset(VideoBitratePreset preset) método.
static class
PublisherKit.VideoLayerStats
Representa as estatísticas de uma única camada de vídeo publicada.
static interface
PublisherKit.VideoListener
Monitora quando o editor começa e para de receber dados de vídeo.
static interface
PublisherKit.VideoStatsListener
Define o objeto ouvinte para obter as estatísticas de vídeo do editor.
class
PublisherKit.VideoTransformer
Um transformador para um fluxo de vídeo.
Resumo do campo
Campos
Modificador e Tipo
Campo
Descrição
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 a condição da rede do participante local mudou.
protected PublisherKit.PublisherListener
publisherListener
protected BaseVideoRenderer
renderer
protected PublisherKit.PublisherRtcStatsReportListener
rtcStatsReportListener
static final String
VIDEO_REASON_CODEC_CHANGE
O codec de vídeo da transmissão foi alterado.
static final String
VIDEO_REASON_NONE
static final String
VIDEO_REASON_QUALITY
O problema com o vídeo foi causado por uma mudança no nível de congestionamento da rede.
static final String
VIDEO_REASON_QUALITY_DEGRADATION_BANDWIDTH
Deterioração da qualidade devido à largura de banda insuficiente da rede.
static final String
VIDEO_REASON_QUALITY_DEGRADATION_CPU
Deterioração da qualidade causada por limitações da CPU no dispositivo cliente.
static final String
VIDEO_REASON_QUALITY_DEGRADATION_OTHER
Deterioração da qualidade causada por outros motivos.
static final String
VIDEO_REASON_RESOLUTION_CHANGE
Alteração na resolução do vídeo ou no número de camadas.
protected PublisherKit.VideoListener
videoListener
protected PublisherKit.VideoStatsListener
videoStatsListener
Resumo do Construtor
Construtores
Modificador
Construtor
Descrição
protected
PublisherKit(PublisherKit.Builder builder)
Resumo do método
Todos os métodosMétodos de instânciaMétodos concretosMétodos obsoletos
Modificador e Tipo
Método
Descrição
void
destroy()
Libera este objeto, incluindo todos os recursos de hardware e da interface do usuário vinculados a ele, caso não possa ser liberado pelo coletor de lixo.
protected void
finalize()
É chamado pelo coletor de lixo quando este determina que não há mais referências ao objeto PublisherKit.
BaseVideoCapturer
getCapturer()
Retorna o capturador de vídeo utilizado por este editor.
PublisherKit.DegradationPreference
getDegradationPreference()
Obtém a política preferencial que o mecanismo de vídeo seguirá ao ajustar a taxa de quadros e a resolução de acordo com condições de largura de banda e CPU limitadas.
int
getMaxVideoBitrate()
Obtém a taxa de bits máxima do fluxo de vídeo do editor, em bits por segundo.
String
getName()
O nome do stream.
boolean
getPublishAudio()
Independentemente de a editora estar publicando áudio (true) ou não (
false).
boolean
getPublishCaptions()
Independentemente de o Editor estar publicando legendas (true) ou não (
false).
PublisherKit.PublisherKitVideoType
getPublisherVideoType()
Retorna o tipo de vídeo desse editor.
boolean
getPublishVideo()
Independentemente de o Editor estar publicando um vídeo (true) ou não (
false).
BaseVideoRenderer
getRenderer()
Retorna o renderizador de vídeo para este editor.
void
getRtcStatsReport()
Obtém o relatório de estatísticas do RTC para o editor.
Session
getSession()
Retorna o Session vinculado a esta instância do Publisher.
Stream
getStream()
Retorna o objeto de fluxo correspondente ao fluxo do Publisher.
String
getTargetScalabilityMode()
Obtém o modo de escalabilidade de destino que foi definido explicitamente por meio do método setTargetScalabilityMode.
PublisherKit.VideoBitratePreset
getVideoBitratePreset()
Obtém a predefinição de taxa de bits de vídeo atualmente ativa para a transmissão do editor.
android.view.View
getView()
Retorna o objeto `android.view.View` que contém o vídeo do `Publisher`.
protected void
onAudioLevelUpdated(float audioLevel)
É chamado periodicamente para informar o nível de áudio do editor.
protected void
onError(OpentokError error)
É acionado quando o editor falha.
protected void
onMuteForced()
É acionado quando um moderador força esse editor a silenciar o áudio.
void
onPause()
Não ligue diretamente; ligue para Session.onPause() em vez disso.
void
onRestart()
Reinicia os recursos do editor que haviam sido liberados anteriormente por meio da chamada da função
onStop() método.
void
onResume()
Não ligue diretamente; ligue para Session.onResume() em vez disso.
protected void
onRtcStatsReport(PublisherKit.PublisherRtcStats[] stats)
É chamado quando o relatório de estatísticas RTC do editor fica disponível, em resposta a uma
chamada para getRtcStatsReport().
void
onStop()
Libera os recursos vinculados à editora.
protected void
onStreamCreated(Stream stream)
É chamado quando o fluxo do editor é criado.
protected void
onStreamDestroyed(Stream stream)
É chamado quando o fluxo do publisher é destruído.
void
setAudioLevelListener(PublisherKit.AudioLevelListener listener)
Vincula um PublisherKit.AudioLevelListener a esta instância do PublisherKit para monitorar
as atualizações do nível de áudio.
void
setAudioStatsListener(PublisherKit.AudioStatsListener listener)
Configura um ouvinte para as estatísticas de áudio do publisher.
void
setAudioTransformers(ArrayList<PublisherKit.AudioTransformer> audioTransformers)
Define uma lista de transformadores de áudio para o fluxo de áudio deste editor.
void
setCapturer(BaseVideoCapturer newCapturer)
Obsoleto.
void
setDegradationPreference(PublisherKit.DegradationPreference degradationPreference)
Obtém a política preferencial que o mecanismo de vídeo seguirá ao ajustar a taxa de quadros e a resolução de acordo com condições de largura de banda e CPU limitadas.
void
setMaxVideoBitrate(int maxVideoBitrate)
Define a taxa de bits máxima do vídeo para a transmissão do editor, em bits por segundo.
void
setMediaLinkStatsListener(PublisherKit.MediaLinkStatsListener listener)
Configura um ouvinte para as estatísticas de links de mídia do publisher.
void
setMuteListener(PublisherKit.MuteListener listener)
Define um PublisherKit.MuteListener objeto a ser monitorado quando um moderador obrigar
esse editor a silenciar o áudio.
void
setName(String name)
Obsoleto.
void
setPublishAudio(boolean publishAudio)
Ativa ou desativa a publicação de áudio, com base no valor passado como parâmetro.
void
setPublishCaptions(boolean publishCaptions)
Ativa ou desativa a exibição das legendas, com base no valor passado como parâmetro.
void
setPublisherListener(PublisherKit.PublisherListener listener)
Associa um PublisherKit.PublisherListener a esta instância do Publisher para monitorar
mudanças de estado.
void
setPublisherVideoType(PublisherKit.PublisherKitVideoType type)
Especifica o tipo de vídeo para esta transmissão.
void
setPublishVideo(boolean publishVideo)
Ativa ou desativa a publicação do vídeo, com base no valor passado como parâmetro.
void
setRenderer(BaseVideoRenderer renderer)
Obsoleto.
void
setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener listener)
Define o ouvinte do relatório de estatísticas do RTC como assinante.
void
setStyle(String key, String value)
Define um estilo para o renderizador de vídeo utilizado por este editor.
void
setTargetScalabilityMode(String scalabilityMode)
Define o modo de escalabilidade de destino (SVC – Scalable Video Coding) para este editor.
void
setVideoBitratePreset(PublisherKit.VideoBitratePreset videoBitratePreset)
Define uma estratégia de predefinição de taxa de bits de vídeo para a transmissão de vídeo do editor.
void
setVideoListener(PublisherKit.VideoListener listener)
Define um PublisherKit.VideoListener objeto para monitorar quando o editor começa
e para de enviar vídeo.
void
setVideoStatsListener(PublisherKit.VideoStatsListener listener)
Configura um ouvinte para as estatísticas de vídeo do editor.
void
setVideoTransformers(ArrayList<PublisherKit.VideoTransformer> videoTransformers)
Define uma lista de transformadores de vídeo para o fluxo de vídeo deste editor.
void
update(Observable o, Object arg)
Obsoleto.
Métodos herdados da classe java.lang.Objeto
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Detalhes do campo
VÍDEO_MOTIVO_NENHUM
público estático final String VÍDEO_MOTIVO_NENHUM
Veja também: : - [Valores de campo constantes]
VÍDEO_MOTIVO_QUALIDADE
público estático final String VÍDEO_MOTIVO_QUALIDADE
O problema com o vídeo foi causado por uma mudança no nível de congestionamento da rede.
O
PublisherKit.VideoListener.onVideoDisabled(PublisherKit, String) método é
chamado.
Quando as condições melhoram, a transmissão de vídeo é retomada, e o
PublisherKit.VideoListener.onVideoEnabled(PublisherKit, String) O método é
chamado.
Quando o fluxo de vídeo é interrompido, o assinante continua recebendo o fluxo de áudio, caso haja um.
Veja também:
: - method.
- method.
- [Valores constantes do campo]
VÍDEO_MOTIVO_DEGRADAÇÃO_DA_QUALIDADE_LARGURA_DE_BANDA
público estático final String VÍDEO_MOTIVO_DEGRADAÇÃO_DA_QUALIDADE_LARGURA_DE_BANDA
Deterioração da qualidade devido à largura de banda insuficiente da rede.
Veja também: : - [Valores de campo constantes]
VÍDEO_MOTIVO_DEGRADAÇÃO_DA_QUALIDADE_CPU
público estático final String VÍDEO_MOTIVO_DEGRADAÇÃO_DA_QUALIDADE_CPU
Deterioração da qualidade causada por limitações da CPU no dispositivo cliente.
Veja também: : - [Valores de campo constantes]
VÍDEO_MOTIVO_DEGRADAÇÃO_DA_QUALIDADE_OUTROS
público estático final String VÍDEO_MOTIVO_DEGRADAÇÃO_DA_QUALIDADE_OUTROS
Deterioração da qualidade causada por outros motivos.
Veja também: : - [Valores de campo constantes]
MOTIVO_DA_MUDANÇA_DE_CODEC_DO_VÍDEO
público estático final String MOTIVO_DA_MUDANÇA_DE_CODEC_DO_VÍDEO
O codec de vídeo da transmissão foi alterado.
Veja também: : - [Valores de campo constantes]
VÍDEO_MOTIVO_ALTERAÇÃO_DA_RESOLUÇÃO
público estático final String VÍDEO_MOTIVO_ALTERAÇÃO_DA_RESOLUÇÃO
Alteração na resolução do vídeo ou no número de camadas. Isso pode ocorrer devido a restrições de taxa de bits, adaptação do codificador, alterações na fonte da câmera (por exemplo, troca de câmera ou alteração da resolução de entrada) ou alterações na configuração. Nem sempre implica em perda de qualidade.
Veja também: : - [Valores de campo constantes]
MOTIVO_DE_REDE_ALTERAÇÃO_NAS_CONDIÇÕES_DE_REDE
público estático final String MOTIVO_DE_REDE_ALTERAÇÃO_NAS_CONDIÇÕES_DE_REDE
Indica que a condição da rede do participante local mudou. Este evento é acionado quando é detectada uma mudança significativa na condição da rede.
Veja também: : - [Valores de campo constantes]
manipulador
handler protegido do 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
renderizador
protegido BaseVideoRenderer renderizador
capturador
protegido BaseVideoCapturer capturador
videoListener
protegido PublisherKit.VideoListener videoListener
Detalhes do construtor
PublisherKit
protected PublisherKit(PublisherKit.Builder construtor)
Detalhes do método
onPause
public void onPause()
Não ligue diretamente; ligue para Session.onPause() em vez disso.
onResume
public void onResume()
Não ligue diretamente; ligue para Session.onResume() em vez disso.
destruir
public void destruir()
Libera este objeto, incluindo todos os recursos de hardware e da interface do usuário vinculados a ele, caso não possa ser liberado pelo coletor de lixo. Geralmente, os recursos são liberados com segurança pelo coletor de lixo, e não é necessário chamar este método. No entanto, isso pode ocorrer a qualquer momento, a critério da VM, o que pode não ser o comportamento desejado em alguns casos. Este método permite liberar recursos manualmente em cenários em que se deseja que a liberação seja imediata:
- Um aplicativo deseja publicar novamente, mas precisa ter acesso à câmera imediatamente após a retirada da publicação.
- Um aplicativo quer garantir que o dispositivo de áudio seja liberado imediatamente após a retirada da publicação.
Depois de chamar esse método, não é possível reutilizar o publisher.
setPublishVideo
public void setPublishVideo(boolean publishVideo)
Ativa ou desativa a publicação do vídeo, com base no valor passado como parâmetro.
Parâmetros:
: publishVideo - Se deve publicar o vídeo (true) ou não (
false).
setPublishAudio
public void setPublishAudio(boolean publishAudio)
Ativa ou desativa a publicação de áudio, com base no valor passado como parâmetro.
Parâmetros:
: publishAudio - Se deve publicar o áudio (true) ou não (
false).
setPublishCaptions
public void setPublishCaptions(boolean publishCaptions)
Ativa ou desativa a exibição das legendas, com base no valor passado como parâmetro.
Parâmetros:
: publishCaptions - Se as legendas devem ser publicadas (true) ou não (
false).
setName
@Obsoleto public void setName(String nome)
Obsoleto.
Defina o nome desta transmissão. O nome aparece na parte inferior do
vídeo do emissor e na parte inferior dos vídeos dos assinantes associados à
transmissão publicada. Você pode definir esse nome após inicializar o
emissor e antes do
PublisherKit.PublisherListener.onStreamCreated(PublisherKit publisher, Stream stream)
o método é chamado. Definir a propriedade após o
PublisherKit.PublisherListener.onStreamCreated(PublisherKit publisher, Stream stream)
O método chamado não tem efeito sobre o nome exibido para o fluxo.
O nome padrão é "" (uma string vazia).
definirTipoDeVídeoDaEditora
public void definirTipoDeVídeoDoEditor(PublisherKit.PublisherKitVideoType tipo)
Especifica o tipo de vídeo para esta transmissão. Defina este parâmetro como um dos seguintes valores:
PublisherKitVideoType.PublisherKitVideoTypeScreen— Otimiza a codificação de vídeo para o compartilhamento de tela. Recomenda-se usar uma baixa taxa de quadros (5 quadros por segundo ou menos) com esse tipo de vídeo. Veja O OpenTok Media Router e os modos de mídia.PublisherKitVideoType.PublisherKitVideoTypeCamera— Essa é a configuração padrão, que você deve usar ao utilizar uma câmera como fonte de vídeo.
getName
público String getName()
O nome da transmissão. O nome aparece na parte inferior dos vídeos dos assinantes.
Retornos: : nome da editora
getPublishVideo
public boolean getPublishVideo()
Independentemente de o Editor estar publicando um vídeo (true) ou não (
false).
getPublishAudio
public boolean getPublishAudio()
Independentemente de a editora estar publicando áudio (true) ou não (
false).
getPublishCaptions
public boolean getPublishCaptions()
Independentemente de o Editor estar publicando legendas (true) ou não (
false).
getSession
público Sessão getSession()
Retorna o Session vinculado a esta instância do Publisher.
Retornos:
: O Session vinculado a esta instância do Publisher.
Veja também:
: - Session.publish(com.opentok.android.PublisherKit)
getStream
público Transmissão getStream()
Retorna o objeto de fluxo correspondente ao fluxo do Publisher.
Retorna: : O objeto stream.
getPublisherVideoType
público PublisherKit.PublisherKitVideoType getPublisherVideoType()
Retorna o tipo de vídeo desse editor.
Veja também:
: - setPublisherVideoType(PublisherKitVideoType type)
getMaxVideoBitrate
public int getMaxVideoBitrate()
Obtém a taxa de bits máxima do fluxo de vídeo do editor, em bits por segundo.
Retorna o limite máximo configurado no momento. Se nenhuma taxa de bits manual tiver sido definida, ou se uma predefinição de taxa de bits estiver ativa, o valor é 0.
Retorna: : A taxa de bits máxima do vídeo em bits por segundo, ou 0 se não estiver definida ou se estiver sendo usada uma predefinição.
Veja também:
: - setMaxVideoBitrate(int maxVideoBitrate)
setMaxVideoBitrate
public void setMaxVideoBitrate(int maxVideoBitrate)
Define a taxa de bits máxima do vídeo para a transmissão do editor, em bits por segundo.
Esse método aplica um limite máximo explícito à taxa de bits do vídeo do editor. Definir o valor como 0 remove qualquer limite manual e reverte para o comportamento padrão de taxa de bits adaptativa baseada em predefinições, sem limite explícito.
Parâmetros:
: maxVideoBitrate - A taxa de bits máxima do vídeo, em bits por segundo,
entre 5.000 e 10.000.000.
Veja também:
: - getMaxVideoBitrate()
- setVideoBitratePreset(VideoBitratePreset videoBitratePreset)
- Taxa de bits máxima do editor
getVideoBitratePreset
público PublisherKit.VideoBitratePreset getVideoBitratePreset()
Obtém a predefinição de taxa de bits de vídeo atualmente ativa para a transmissão do editor.
Retorna a estratégia predefinida em uso. Se uma taxa de bits personalizada tiver sido definida manualmente
usando setMaxVideoBitrate(int), esse método retorna
PublisherKit.VideoBitratePreset.VideoBitratePresetCustom.
Retornos:
: O ativo PublisherKit.VideoBitratePreset.
Veja também:
: - setVideoBitratePreset(VideoBitratePreset videoBitratePreset)
definir predefinição de taxa de bits de vídeo
public void setVideoBitratePreset(PublisherKit.VideoBitratePreset (predefinição de taxa de bits de vídeo)
Define uma estratégia de predefinição de taxa de bits de vídeo para a transmissão de vídeo do editor.
As configurações predefinidas equilibram a qualidade do vídeo e o uso da largura de banda por meio de estratégias pré-definidas.
As configurações predefinidas e as configurações manuais de taxa de bits são mutuamente exclusivas.
Definir a setMaxVideoBitrate(int) esse método substitui qualquer predefinição e
altera automaticamente a predefinição ativa para PublisherKit.VideoBitratePreset.VideoBitratePresetCustom.
Observação: O PublisherKit.VideoBitratePreset.VideoBitratePresetCustom O valor não pode ser definido diretamente.
Parâmetros:
: videoBitratePreset - O PublisherKit.VideoBitratePreset para se inscrever.
Veja também:
: - getVideoBitratePreset()
- setMaxVideoBitrate(int maxVideoBitrate)
- Taxa de bits máxima do editor
getDegradationPreference
público PublisherKit.PreferênciaDeDegradação getDegradationPreference()
Obtém a política preferencial que o mecanismo de vídeo seguirá ao ajustar a taxa de quadros e a resolução de acordo com
condições de largura de banda e CPU limitadas. Consulte PublisherKit.DegradationPreference para obter uma descrição dos valores possíveis.
Retorna: : A preferência de degradação atual.
definirPreferênciaDeDegradação
public void setDegradationPreference(PublisherKit.PreferênciaDeDegradação (preferência de degradação)
Obtém a política preferencial que o mecanismo de vídeo seguirá ao ajustar a taxa de quadros e a resolução de acordo com
condições de largura de banda e CPU limitadas. Consulte PublisherKit.DegradationPreference para obter uma descrição dos valores possíveis.
Parâmetros:
: degradationPreference - A preferência de degradação.
setTargetScalabilityMode
public void setTargetScalabilityMode(String scalabilityMode)
Define o modo de escalabilidade alvo (SVC — Codificação de Vídeo Escalável) para este editor. O modo de escalabilidade controla o número de camadas espaciais (resolução) e temporais (taxa de quadros) que o WebRTC codifica. O modo é aplicado ao caminho de mídia do Media Router. Este método pode ser chamado a qualquer momento — não é necessário que a negociação do caminho de mídia tenha sido concluída. O modo será aplicado assim que o caminho de mídia do Media Router for estabelecido. Se um codec diferente do SVC (VP8, H.264) for negociado no caminho de mídia do Media Router, o modo aplicável mais próximo será usado: as camadas espaciais são forçadas a 1, preservando a dimensão temporal (por exemplo, L2T2 → L1T2 quando o VP8 é negociado). Este é um recurso em fase beta.
Parâmetros:
: scalabilityMode - O modo de escalabilidade desejado.
Arremessos:
: IllegalArgumentException - se o modo solicitado não for um modo de escalabilidade válido
(ou seja, não for um dos seguintes: L1T1, L1T2, L1T3, L2T1, L2T2, L2T3, L3T1, L3T2, L3T3).
getTargetScalabilityMode
público String getTargetScalabilityMode()
Obtém o modo de escalabilidade de destino que foi definido explicitamente por meio do método setTargetScalabilityMode. Retorna o último valor passado ao setter ou `null`, caso o setter nunca tenha sido chamado. Isso reflete a intenção do usuário, e não o modo efetivamente aplicado (que pode diferir devido a um fallback dependente do codec). Este é um recurso em fase beta.
Retorna: : O modo de escalabilidade de destino definido pelo chamador, ou nulo caso não tenha sido explicitamente definido.
setPublisherListener
public void setPublisherListener(PublisherKit.PublisherListener ouvinte)
Associa um PublisherKit.PublisherListener a esta instância do Publisher para monitorar
mudanças de estado.
Parâmetros:
: listener - O PublisherKit.PublisherListener que monitorará esta instância, ou `null`
para desconectar um ouvinte.
setAudioLevelListener
public void setAudioLevelListener(PublisherKit.AudioLevelListener ouvinte)
Vincula um PublisherKit.AudioLevelListener a esta instância do PublisherKit para monitorar
as atualizações do nível de áudio.
Parâmetros:
: listener - O PublisherKit.AudioLevelListener que monitorará esta instância. Defina
este valor como nulo para desconectar um ouvinte e interromper o monitoramento dos níveis de áudio.
setRtcStatsReportListener
public void setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener ouvinte)
Define o ouvinte do relatório de estatísticas do RTC como assinante. Consulte getRtcStatsReport().
Parâmetros:
: listener - O PublisherKit.PublisherRtcStatsReportListener objeto.
definirVideoTransformadores
public void setVideoTransformers(ArrayList<PublisherKit.VideoTransformer> (videoTransformers)
Define uma lista de transformadores de vídeo para o fluxo de vídeo deste editor. Se a lista estiver vazia, a chamada a este método reinicializa os transformadores. A matriz pode ser composta por transformadores de vídeo da Vonage fornecidos pela ml-library ou por transformadores personalizados (consulte este guia para desenvolvedores). Observação: Os transformadores de mídia não são compatíveis com todos os dispositivos ou versões do Android. Veja esta documentação.
Parâmetros:
: videoTransformers - A lista de transformadores de vídeo, na ordem em que serão aplicados ao fluxo.
setVideoListener
public void setVideoListener(PublisherKit.VideoListener ouvinte)
Define um PublisherKit.VideoListener objeto para monitorar quando o editor começa
e para de enviar vídeo.
Parâmetros:
: listener - O PublisherKit.VideoListener instância.
setAudioTransformers
public void setAudioTransformers(ArrayList<PublisherKit.AudioTransformer> (audioTransformers)
Define uma lista de transformadores de áudio para o fluxo de áudio deste editor. Se a lista estiver vazia, a chamada a este método reinicializa os transformadores. A matriz pode ser composta por transformadores de áudio da Vonage fornecidos pela ml-library ou por transformadores personalizados (consulte este guia para desenvolvedores). Observação: Os transformadores de mídia não são compatíveis com todos os dispositivos ou versões do Android. Veja esta documentação. .
Parâmetros:
: audioTransformers - A lista de transformadores de áudio, na ordem em que devem ser aplicados ao fluxo.
setStyle
public void setStyle(String chave, String valor)
Define um estilo para o renderizador de vídeo utilizado por este editor.
Por padrão, há apenas uma chave de estilo predefinida:
BaseVideoRenderer.STYLE_VIDEO_SCALE. Você pode definir um valor para essa
chave a fim de determinar o redimensionamento do vídeo. Os seguintes valores são
aceitos:
BaseVideoRenderer.STYLE_VIDEO_FILL— O vídeo é redimensionado para preencher toda a área do renderizador, com recorte conforme necessário.BaseVideoRenderer.STYLE_VIDEO_FIT— O vídeo é reduzido, conforme necessário, de modo que todo o vídeo fique visível, com barras laterais. Se você não definir esse estilo, a configuração padrão éBaseVideoRenderer.STYLE_VIDEO_FIT.
Chamar esse método equivale a chamar
getRenderer().setStyle(). No entanto, se você estender essa classe,
poderá sobrescrever esse método para oferecer suporte a outros estilos e comportamentos.
Parâmetros:
: key - O estilo a ser definido.
: value - O valor ao qual você está definindo o estilo.
setRenderer
@Obsoleto public void setRenderer(BaseVideoRenderer renderizador)
Obsoleto.
Define o renderizador de vídeo para este editor.
Esse método está obsoleto. Em vez disso, chame
o PublisherKit.Builder.renderer(BaseVideoRenderer renderer) método ao
usar o Builder para criar a instância do PublisherKit.
getRenderer
público BaseVideoRenderer getRenderer()
Retorna o renderizador de vídeo para este editor.
getCapturer
público BaseVideoCapturer getCapturer()
Retorna o capturador de vídeo utilizado por este editor.
setCapturer
@Obsoleto public void setCapturer(BaseVideoCapturer newCapturer)
Obsoleto.
Define o capturador de vídeo para este editor.
Esse método está obsoleto. Em vez disso, chame o
PublisherKit.Builder.capturer(BaseVideoCapturer capturer) método ao usar
o construtor para criar a instância do PublisherKit.
getView
public android.view.View getView()
Retorna o objeto `android.view.View` que contém o vídeo do `Publisher`.
setVideoStatsListener
public void setVideoStatsListener(PublisherKit.VideoStatsListener ouvinte)
Configura um ouvinte para as estatísticas de vídeo do publisher. O objeto ouvinte implementa a interface
PublisherKit.VideoStatsListener.onVideoStats(PublisherKit publisher, PublisherKit.PublisherVideoStats[] stats) método e, opcionalmente, o
PublisherKit.VideoStatsListener.onVideoQualityChanged(PublisherKit, PublisherVideoStats, String) método.
Veja também:
: - setAudioStatsListener(AudioStatsListener listener)
setAudioStatsListener
public void setAudioStatsListener(PublisherKit.AudioStatsListener ouvinte)
Configura um ouvinte para as estatísticas de áudio do publisher. O objeto ouvinte implementa a interface
PublisherKit.AudioStatsListener.onAudioStats(PublisherKit publisher, PublisherKit.PublisherAudioStats[] stats) método. Esse método é chamado periodicamente para relatar
o seguinte:
- Total de pacotes de áudio perdidos
- Total de pacotes de áudio enviados
- Total de bytes de áudio enviados
Veja também:
: - setVideoStatsListener(VideoStatsListener listener)
setMediaLinkStatsListener
public void setMediaLinkStatsListener(PublisherKit.MediaLinkStatsListener ouvinte)
Configura um ouvinte para as estatísticas de links de mídia do publisher. O objeto ouvinte implementa a interface
PublisherKit.MediaLinkStatsListener.onMediaLinkStats(PublisherKit, PublisherMediaLinkStats[])
e PublisherKit.MediaLinkStatsListener.onNetworkConditionChanged(PublisherKit, PublisherMediaLinkStats, String)
métodos.
Parâmetros:
: listener - O PublisherKit.MediaLinkStatsListener instância ou `null` para remover.
Veja também:
: - setVideoStatsListener(VideoStatsListener listener)
- setAudioStatsListener(AudioStatsListener listener)
setMuteListener
public void setMuteListener(PublisherKit.MuteListener ouvinte)
Define um PublisherKit.MuteListener objeto a ser monitorado quando um moderador obrigar
esse editor a silenciar o áudio.
Parâmetros:
: listener - O PublisherKit.MuteListener instância.
getRtcStatsReport
public void getRtcStatsReport()
Obtém o relatório de estatísticas do RTC para o editor. Esta é uma operação assíncrona.
Chame a função setRtcStatsReportListener(PublisherKit.PublisherRtcStatsReportListener listener)
método e, em seguida, implementar o
PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherKit.PublisherRtcStats[] stats)
método antes de chamar este método. Quando as estatísticas estiverem disponíveis, a implementação
do PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherKit.PublisherRtcStats[] stats)
o método é chamado.
Veja também setAudioStatsListener(PublisherKit.AudioStatsListener listener),
setVideoStatsListener(PublisherKit.VideoStatsListener listener), e
SubscriberKit.getRtcStatsReport().
onRtcStatsReport
protected void onRtcStatsReport(PublisherKit.PublisherRtcStats[] estatísticas)
É chamado quando o relatório de estatísticas RTC do editor fica disponível, em resposta a uma
chamada para getRtcStatsReport().
Se você estender a classe PublisherKit, poderá sobrescrever este método em vez de implementar o método onRtcStatsReport() da interface PublisherKit.PublisherRtcStatsReportListener.
Veja também:
: - PublisherKit.PublisherRtcStatsReportListener.onRtcStatsReport(PublisherKit publisher, PublisherRtcStats[] stats)
onStreamCreated
protected void onStreamCreated(Transmissão (stream)
É chamado quando o fluxo do editor é criado.
Se você estender a classe PublisherKit, poderá sobrescrever este método em vez do
onStreamCreated() método da interface PublisherKit.PublisherListener
.
Parâmetros:
: stream - O fluxo que é criado.
onStreamDestroyed
protected void onStreamDestroyed(Transmissão (stream)
É chamado quando o fluxo do publisher é destruído.
Se você estender a classe PublisherKit, poderá sobrescrever este método em vez do
onStreamDestroyed() método da interface PublisherKit.PublisherListener
.
Parâmetros:
: stream - O fluxo que é destruído.
onError
protected void onError(OpentokError erro)
É acionado quando o editor falha.
Se você estender a classe PublisherKit, poderá sobrescrever este método em vez do
onError() método da interface PublisherKit.PublisherListener
.
Parâmetros:
: error - O erro que acionou essa função de retorno de chamada.
onAudioLevelUpdated
protected void onAudioLevelUpdated(float audioLevel)
É chamado periodicamente para informar o nível de áudio do editor.
Parâmetros:
: audioLevel - O nível de áudio, de 0 a 1,0. Ajuste esse valor
logarítmicamente para uso na visualização de uma interface de usuário
(como um medidor de volume).
onMuteForced
protected void onMuteForced()
É acionado quando um moderador força esse editor a silenciar o áudio.
Se você estender a classe PublisherKit, poderá sobrescrever este método em vez do
onMuteForced() método da interface PublisherKit.MuteListener
.
atualização
@Obsoleto public void atualizar(Observável o, Objeto arg)
Obsoleto.
Esse método é chamado sempre que o objeto observado sofre alguma alteração. Essa classe implementa a interface Observer, portanto, ela observa eventos, como os eventos de pausa e retomada da sessão.
Especificado por:
: update na interface Observer
Parâmetros:
: o - O objeto observável.
: arg - Um argumento passado ao método `notifyObservers`.
finalizar
protected void finalize() throws Arremessável
É chamado pelo coletor de lixo quando este determina que não há mais referências ao objeto PublisherKit.
Substituições:
: finalize na aula Object
Arremessos:
: Throwable
onStop
public void onStop()
Libera os recursos vinculados ao publisher. A chamada a este método faz com que o publisher
interrompa a captura e, em seguida, libere a câmera. Para reutilizar o publisher após
chamar este método, chame o onRestart() método.
onRestart
public void onRestart()
Reinicia os recursos do editor que haviam sido liberados anteriormente por meio da chamada da função
onStop() método.