Um publisher captura um fluxo de áudio e vídeo das fontes que você especificar. Mais...

Herdou da interface IDisposable.

Descrição detalhada

Um publisher captura um fluxo de áudio e vídeo das fontes que você especificar.

Use o Publisher.Builder classe para criar um Editora instância. Em seguida, você pode publicar o fluxo de áudio e vídeo em uma sessão da Video API da Vonage chamando a Session.Publish(Publisher) método.

O Editora A classe implementa a interface System.IDisposable. Certifique-se de chamar o Dispose() método do 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).

Documentação sobre a enumeração de membros

VideoReason

Define valores para o VideoEventArgs.Reason e VideoEventArgs.Reason propriedades.

Documentação das funções de membro

Dispose()

Dispõe do Editora recursos do objeto.

Observe que o EditoraOs recursos de... são não é descartado quando você chama o Session.Publish(Publisher) método. Quando você chama Session.Publish(Publisher), os recursos do Editora O objeto é mantido para que você possa reutilizá-lo (para publicar novamente na sessão).

GetRtcStatsReport()

Obtém o relatório de estatísticas do RTC para o editor. Esta é uma operação assíncrona. Quando as estatísticas estiverem disponíveis, o RtcStatsReport A mensagem é enviada.

Veja também Estatísticas de áudio atualizadas, Estatísticas de vídeo atualizadas, e Subscriber.GetRtcStatsReport().

Documentação do imóvel

Taxa de bits máxima de vídeo

A taxa de bits máxima do vídeo para a transmissão do editor (em bits por segundo).

Essa propriedade define um limite máximo explícito para a taxa de bits do vídeo do editor. Ao definir essa propriedade como 0, qualquer limite manual é removido e o sistema volta ao comportamento padrão de taxa de bits adaptativa baseada em predefinições, sem limite explícito.

A leitura desta propriedade retorna a taxa de bits máxima configurada no momento, 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 não há limite explícito de taxa de bits aplicado e que o fluxo opera de acordo com regras de predefinição adaptativa para otimizar a qualidade.

Publicar Vídeo

TargetScalabilityMode

O modo de escalabilidade alvo (SVC – Scalable Video Coding) 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.

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 que não seja SVC (VP8, H.264) for negociado no caminho de mídia do Media Router, será utilizado o modo aplicável mais próximo: as camadas espaciais são forçadas a 1, preservando a dimensão temporal (por exemplo, L2T2 → L1T2 quando o VP8 é negociado).

O levantador 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.

Predefinição de taxa de bits de vídeo

A estratégia de predefinição da taxa de bits de vídeo aplicada ao fluxo de vídeo do editor.

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 desta 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.

Documentação do evento

Alteração na condição da rede

Ocorre quando são detectadas alterações nas condições da rede no lado do editor.

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.

Vídeo desativado

É chamado quando o provedor de conteúdo interrompe a transmissão do vídeo.

Verifique o reason propriedade dos argumentos do evento que indica o motivo pelo qual o vídeo parou.

Desativar aviso de vídeo

É chamado quando o editor determina que o nível de congestionamento da rede piorou e que o vídeo será desativado caso o congestionamento piore ainda mais.

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

É chamado quando o editor determina que o nível de congestionamento da rede melhorou a ponto de o vídeo que está sendo desativado não representar mais um risco imediato.

Esse método é chamado principalmente quando a qualidade da conexão melhora.

Compatível com vídeo

É chamado quando a transmissão de vídeo do editor é retomada (após o vídeo ter sido desativado).

Verifique o reason propriedade dos argumentos do evento que indica o motivo pelo qual o vídeo foi ativado.

Qualidade do vídeo alterada

Ocorre quando há uma alteração no estado de qualidade do fluxo de vídeo do emissor.

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 VideoReason O valor 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 do Vídeo desativado e Compatível com vídeo eventos, na medida em que relata alterações relacionadas à qualidade, em vez de simples mudanças de estado (ligado/desligado). O Vídeo desativado e Compatível com vídeo Os eventos indicam quando a trilha de vídeo do editor é desativada ou ativada (por exemplo, devido a um fallback de áudio ou a atualizações nas propriedades do stream). Em contrapartida, Qualidade do vídeo alterada fornece informações de diagnóstico sobre as causas da degradação da qualidade — como limitações da CPU ou da largura de banda — e pode ser gerado 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.