OpenTok.Publisher
public class Publisher : IDisposable
Use o Publisher.Builder classe para criar um Editora instância. Em seguida, você pode publicar o fluxo de áudio e vídeo em um OpenTok sessão chamando o método Session.Publish(Publisher).
O Editora A classe implementa a interface System.IDisposable. Certifique-se de chamar o método Dispose() da Editora objeto deve liberar seus recursos quando você não precisar mais dele (por exemplo, quando o Editora for removido ou quando o aplicativo ou a janela estiver sendo fechado).
Tipos aninhados: OpenTok.Publisher.VideoEventArgs, OpenTok.Publisher.Builder, OpenTok.Publisher.StreamEventArgs, OpenTok.Publisher.ErrorEventArgs, OpenTok.Publisher.AudioLevelArgs, OpenTok.Publisher.AudioNetworkStats, OpenTok.Publisher.AudioNetworkStatsEventArgs, OpenTok.Publisher.VideoNetworkStats, OpenTok.Publisher.VideoLayerStats, OpenTok.Publisher.VideoNetworkStatsEventArgs, OpenTok.Publisher.VideoQualityChangedEventArgs, OpenTok.Publisher.PublisherMediaLinkStats, OpenTok.Publisher.PublisherMediaLinkStatsEventArgs, OpenTok.Publisher.NetworkConditionChangedEventArgs, OpenTok.Publisher.PublisherRtcStats, OpenTok.Publisher.RtcStatsReportArgs
Propriedades
| Nome | Tipo | Descrição |
|---|---|---|
VideoTransformers |
Lista<VideoTransformer> | { get; set; } Lista de VideoTransformer na ordem em que serão aplicadas ao fluxo. Consulte a documentação sobre Utilizando a biblioteca do Vonage Media Processor e aplicar transformações de mídia. O getter retorna uma cópia da lista. Adicionar ou remover transformadores dessa cópia não afetará as camadas internas. |
AudioTransformers |
Lista<AudioTransformer> | { get; set; } Lista de AudioTransformer na ordem em que serão aplicadas ao fluxo. Consulte a documentação sobre Utilizando a biblioteca do Vonage Media Processor e aplicar transformações de mídia. O getter retorna uma cópia da lista. Adicionar ou remover transformadores dessa cópia não afetará as camadas internas. |
VideoRenderer |
IVideoRenderer | { get; } O renderizador de vídeo para a editora. |
VideoCapturer |
IVideoCapturer | { get; } O capturador de vídeo para a editora. |
Stream |
Transmissão | { get; } O feed deste editor. As propriedades do Transmissão As propriedades do objeto representam um instantâneo do estado do fluxo no momento em que essa propriedade é acessada e não serão atualizadas à medida que o estado do fluxo mudar. |
PublishCaptions |
bool | { get; set; } Se a editora está publicando legendas. |
CaptionsInputLanguage |
sequência de caracteres | { get; set; } O idioma de entrada preferencial para legendas deste editor. Defina um código de idioma compatível com o BCP-47 ou o valor nulo para redefinir para o valor padrão. |
PublishAudio |
bool | { get; set; } Se a editora está publicando áudio. |
PublishVideo |
bool | { get; set; } |
VideoSourceType |
Tipo de fonte de vídeo | { get; set; } O tipo da transmissão (seja de câmera ou compartilhamento de tela), conforme definido pelo OpenTok.VideoSourceType enum. |
MaxVideoBitrate |
int | { get; set; } Essa propriedade define um limite máximo explícito para a taxa de bits do vídeo do editor. Definir essa propriedade 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. A leitura dessa propriedade retorna a taxa de bits máxima atualmente configurada em bps. Se nenhuma taxa de bits manual tiver sido definida, ou se uma predefinição de taxa de bits estiver ativa, o valor será 0. Um valor igual a 0 indica que nenhum limite explícito de taxa de bits está sendo aplicado e que a transmissão opera de acordo com regras de predefinições adaptativas para otimizar a qualidade. |
VideoBitratePreset |
Predefinição de taxa de bits de vídeo | { get; set; } Essa propriedade configura uma estratégia de taxa de bits predefinida para equilibrar a qualidade do vídeo e o uso da largura de banda. As configurações predefinidas e as definições manuais de taxa de bits são mutuamente exclusivas. Definir a propriedade MaxVideoBitrate substitui qualquer configuração predefinida e altera automaticamente essa propriedade para VideoBitratePreset.Custom. A leitura dessa propriedade retorna a predefinição ativa no momento. Se uma taxa de bits personalizada tiver sido definida manualmente, o valor será VideoBitratePreset.Custom. O valor padrão é VideoBitratePreset.Default. Observação: O VideoBitratePreset.Custom O valor não pode ser definido diretamente. Para mais detalhes, consulte Taxa de bits máxima do editor. |
DegradationPreference |
Preferência de degradação | { get; set; } A política preferencial que o mecanismo de vídeo seguirá ao ajustar a taxa de quadros e a resolução de acordo com as condições de largura de banda limitada e de CPU. Consulte a enumeração DegradationPreference para obter uma descrição dos valores possíveis. |
TargetScalabilityMode |
sequência de caracteres | { get; set; } O setter 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 não SVC (VP8, H.264) for negociado no caminho de mídia do Media Router, o modo aplicável mais próximo será utilizado: as camadas espaciais são forçadas a 1, preservando a dimensão temporal (por exemplo, L2T2 → L1T2 quando o VP8 é negociado). O setter lança Exceção OpenTok 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). O getter retorna o último valor passado ao setter ou null, caso não tenha sido explicitamente definido. 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. |
enum VideoReason
Define os valores das propriedades VideoEventArgs.Reason e VideoEventArgs.Reason.
| Nome | Valor | Descrição |
|---|---|---|
None |
0 |
Nenhum evento notável no vídeo nem perda de qualidade. Motivo padrão ou desconhecido. |
PublishVideo |
1 |
O evento ocorreu porque o transmissor iniciou ou interrompeu a transmissão do vídeo. |
Quality |
3 |
Quando a qualidade do fluxo de vídeo diminui devido às condições da rede, o Editora dispacha o evento VideoDisabled. Quando as condições melhorarem, a transmissão de vídeo será retomada, e o Editora dispacha o evento VideoEnabled. Quando o fluxo de vídeo é interrompido, o Editora continua a enviar o fluxo de áudio, caso haja algum. Além disso, o capturador correspondente a esse editor não será desativado, e os quadros capturados continuarão sendo exibidos no lado do editor. |
QualityDegradationBandwidth |
5 |
Deterioração da qualidade devido à largura de banda insuficiente da rede. |
QualityDegradationCPU |
6 |
Deterioração da qualidade causada por limitações da CPU no dispositivo cliente. |
QualityDegradationOther |
7 |
Deterioração da qualidade causada por outros motivos não classificados como restrições de largura de banda ou de CPU. |
CodecChange |
8 |
O codec de vídeo da transmissão foi alterado. |
ResolutionChange |
9 |
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 (como troca de câmera ou alteração da resolução de entrada) ou alterações na configuração. Não implica necessariamente em perda de qualidade. |
Métodos
| Nome | Descrição |
|---|---|
Publisher(builder) |
|
Dispose(disposing) |
|
Dispose() |
Observe que o EditoraOs recursos de... são não são descartados quando você chama o método Session.Publish(Publisher). |
GetRtcStatsReport() |
Consulte também AudioStatsUpdated, VideoStatsUpdated e Subscriber.GetRtcStatsReport(). |
Editora (desenvolvedora)
Parâmetros:
| Nome | Tipo | Descrição |
|---|---|---|
builder |
Construtor |
Descartar (descartando)
Parâmetros:
| Nome | Tipo | Descrição |
|---|---|---|
disposing |
bool |
Dispose()
Observe que o EditoraOs recursos de... são não são liberados quando você chama o método Session.Publish(Publisher). Ao chamar Session.Publish(Publisher), os recursos do Editora O objeto é mantido para que você possa reutilizá-lo (para publicar novamente na sessão).
GetRtcStatsReport()
Consulte também AudioStatsUpdated, VideoStatsUpdated e Subscriber.GetRtcStatsReport().
Eventos
Silenciamento forçado
event EventHandler MuteForced
Define os argumentos para o evento MuteForced.
StreamCreated
event EventHandler<StreamEventArgs> StreamCreated
Enviado quando o stream do editor é criado.
StreamDestruído
event EventHandler<StreamEventArgs> StreamDestroyed
É enviado quando o fluxo do editor é destruído.
Erro
event EventHandler<ErrorEventArgs> Error
A maioria dos erros é fatal: o publisher é automaticamente descartado e não pode mais ser utilizado. Alguns erros permitem a continuação da operação e mantêm o publisher utilizável; quando um erro não é fatal, isso é indicado na descrição do erro.
Qualidade do vídeo alterada
event EventHandler<VideoQualityChangedEventArgs> VideoQualityChanged
Este evento fornece estatísticas atualizadas sobre o vídeo e um código de motivo que indica por que ocorreu a mudança na qualidade.
O valor VideoReason especifica a causa do evento e segue esta ordem de prioridade: degradação da largura de banda, degradação da CPU, outros motivos de degradação da qualidade, alterações no codec e alterações na resolução ou na camada.
Este evento difere dos eventos VideoDisabled e VideoEnabled, pois relata alterações relacionadas à qualidade, em vez de simples mudanças no estado de ativado/desativado. Os eventos VideoDisabled e VideoEnabled indicam quando a trilha de vídeo do editor é desativada ou ativada (por exemplo, devido a um fallback de áudio ou atualizações nas propriedades do stream). Em contrapartida, o evento VideoQualityChanged fornece informações de diagnóstico sobre as causas da degradação da qualidade — como limitações de CPU ou largura de banda — e pode ser acionado mesmo quando o vídeo permanece ativado.
Os aplicativos podem usar esse evento para monitorar a qualidade do vídeo e agir de acordo, por exemplo, atualizando indicadores da interface do usuário ou notificando os usuários sobre problemas de desempenho.
Alteração na condição da rede
event EventHandler<NetworkConditionChangedEventArgs> NetworkConditionChanged
Este evento é acionado quando ocorrem mudanças significativas nas condições da rede, fornecendo estatísticas do link de mídia juntamente com o motivo da mudança.
MediaLinkEstatísticasAtualizadas
event EventHandler<PublisherMediaLinkStatsEventArgs> MediaLinkStatsUpdated
É executado periodicamente para gerar relatórios com as estatísticas de links de mídia para o editor.
Nível de Áudio
event EventHandler<AudioLevelArgs> AudioLevel
Enviado periodicamente para informar o nível de áudio do emissor.
Estatísticas de áudio atualizadas
event EventHandler<AudioNetworkStatsEventArgs> AudioStatsUpdated
É chamado quando o editor tem estatísticas de áudio para compartilhar.
Estatísticas de vídeo atualizadas
event EventHandler<VideoNetworkStatsEventArgs> VideoStatsUpdated
É acionado quando o editor tem estatísticas de vídeo para compartilhar.
RtcStatsReport
event EventHandler<RtcStatsReportArgs> RtcStatsReport
Enviado em resposta a uma chamada à função GetRtcStatsReport().
Vídeo desativado
event EventHandler<VideoEventArgs> VideoDisabled
Verifique o reason propriedade dos argumentos do evento que indica o motivo pelo qual o vídeo parou.
Compatível com vídeo
event EventHandler<VideoEventArgs> VideoEnabled
Verifique o reason propriedade dos argumentos do evento que indica o motivo pelo qual o vídeo foi ativado.
Desativar aviso de vídeo
event EventHandler VideoDisableWarning
Se a rede continuar a apresentar piora, o Editora desativa o vídeo e envia a mensagem AudioFallback. Se a qualidade do stream melhorar, o Editora envia o evento VideoDisableWarningLifted.
Esse método é chamado principalmente quando a qualidade da conexão se deteriora.
Aviso sobre desativação de vídeo suspenso
event EventHandler VideoDisableWarningLifted
Esse método é chamado principalmente quando a qualidade da conexão melhora.