Utilizado para reproduzir um fluxo de áudio e vídeo na sessão da Video API da Vonage. Mais...

Herdou da interface IDisposable.

Descrição detalhada

Utilizado para consumir um fluxo de áudio e vídeo na sessão da Video API da Vonage.

Use o Subscriber.Builder classe para criar um Assinante Por exemplo. Os assinantes podem se conectar para receber mídia quando você chamar o Session.Subscribe(Subscriber) método.

O Assinante A classe implementa a interface System.IDisposable. Certifique-se de chamar o Dispose() método do Assinante objeto deve liberar seus recursos quando você não precisar mais dele (por exemplo, quando o Assinante interrompe a transmissão de vídeo ou quando o aplicativo ou a janela está 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

GetRtcStatsReport()

Obtém o relatório de estatísticas do RTC para o assinante. 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 Publisher.GetRtcStatsReport().

Documentação do imóvel

Volume do áudio

O volume do áudio do assinante.

O volume do áudio do assinante, entre 0 e 100. Ao definir o valor, se ele não estiver nesse intervalo, será ajustado para dentro dele.

O valor padrão é 100.

LegendasTraduçãoIdioma

O idioma preferido para a tradução das legendas deste assinante.

Este é um recurso em fase beta.

Essa configuração só entra em vigor quando as legendas estão ativadas. Defina-a com um código de idioma compatível com o BCP-47 para receber legendas traduzidas, ou null para desativar a tradução. O valor padrão é null (não há tradução configurada).

Os códigos de idiomas compatíveis estão definidos na especificação da API do servidor.

Taxa de quadros preferencial

A taxa de quadros preferencial para a transmissão do assinante.

Limitar a taxa de quadros e a resolução do vídeo (Resolução preferencial) reduz o uso da rede e da CPU no cliente assinante. Você pode optar por usar uma resolução mais baixa com base nas dimensões do vídeo do assinante no aplicativo. Você pode optar por usar uma taxa de quadros ou resolução mais baixa para assinantes de uma transmissão que seja menos importante (e menor) do que outras transmissões.

Essa propriedade só se aplica ao assinar um stream que utilize o recurso de vídeo escalável. O vídeo escalável está disponível:

• Apenas nas sessões que utilizam o Media Router da Video API da Vonage (sessões com o modo de mídia (definido como “roteado”).
• Apenas para transmissões publicadas por clientes que suportam vídeo escalável (consulte a documentação do recurso de vídeo escalável).

Em transmissões que não utilizam vídeo escalável, definir essa propriedade não tem efeito.

Observação: A taxa de quadros para transmissões de vídeo escaláveis se ajusta automaticamente para cada assinante, com base nas condições da rede e no uso da CPU, mesmo que você não defina essa propriedade. Defina essa propriedade se desejar estabelecer uma taxa de quadros máxima para esse assinante.

As taxas de quadros disponíveis são baseadas no valor da taxa de quadros máxima disponível para a transmissão. Ao definir a taxa de quadros preferencial para o assinante, o SDK do Windows da Video API seleciona a melhor taxa de quadros disponível que for mais próxima da taxa preferencial, com base nas restrições de largura de banda e CPU do cliente.

As taxas de quadros efetivamente disponíveis dependem, de forma dinâmica, dos recursos de rede e da CPU disponíveis para o editor.

Resolução preferencial

A resolução preferencial para o stream do assinante.

A resolução preferencial para o stream do assinante.

Limitar a resolução do vídeo e a taxa de quadros (Taxa de quadros preferencial) reduz o uso da rede e da CPU no cliente assinante. Você pode optar por usar uma resolução mais baixa com base nas dimensões do vídeo do assinante no aplicativo. Você pode optar por usar uma taxa de quadros ou resolução mais baixa para assinantes de uma transmissão que seja menos importante (e menor) do que outras transmissões.

Essa propriedade só se aplica ao assinar um stream que utilize o recurso de vídeo escalável. O vídeo escalável está disponível:

• Apenas nas sessões que utilizam o Media Router da Video API da Vonage (sessões com o modo de mídia (definido como “roteado”).
• Apenas para transmissões publicadas por clientes que suportam vídeo escalável (consulte a documentação do recurso de vídeo escalável).

Em transmissões que não utilizam vídeo escalável, definir essa propriedade não tem efeito.

Observação: A resolução das transmissões de vídeo escaláveis é ajustada automaticamente para cada assinante, com base nas condições da rede e no uso da CPU, mesmo que você não defina essa propriedade. Defina essa propriedade se desejar estabelecer uma resolução máxima para esse assinante.

Nem todas as resoluções estão disponíveis para um assinante. Ao definir a resolução preferida, o SDK do Windows da Video API da Vonage seleciona a melhor resolução disponível que atenda às suas restrições. As resoluções disponíveis dependem da largura e altura máximas que o Editora conjuntos para o fluxo, que são retornados pela função Stream.Width e Stream.Height propriedades do Transmissão objeto. Cada uma das resoluções disponíveis para uma transmissão utilizará a mesma proporção de tela.

VideoRenderer

O reprodutor de vídeo utilizado por este assinante.

Defina o renderizador de vídeo passando o VideoRenderer ao chamar o construtor de `Subscriber(Context, Stream, IVideoRenderer)`.

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

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.

Transmissão desconectada

É chamado quando o fluxo do assinante é interrompido.

Em resposta à chamada desse método, talvez seja interessante exibir uma notificação na interface do usuário, para informar ao usuário que o fluxo de áudio e vídeo está temporariamente desconectado e que o aplicativo está tentando se reconectar ao fluxo.

Se o cliente se reconectar ao stream, os assinantes enviam o StreamReconnected evento. Caso contrário, o Sessão o objeto envia o Session.StreamDropped evento.

StreamReconnected

Enviado quando a transmissão do assinante é retomada (após uma desconexão temporária).

O Assinante envia esse evento depois de enviar o Transmissão desconectada evento.

Vídeo desativado

É chamado quando o assinante deixa de receber o 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

É chamada quando o Media Router da Video API da Vonage determina que a qualidade do stream se deteriorou e que o vídeo será desativado caso a qualidade continue a se deteriorar.

Se a qualidade piorar ainda mais, o assinante desativa o vídeo e o Assinante envia a mensagem VideoDisabled. Se a qualidade do stream melhorar, o Assinante envia o evento VideoDisableWarningLifted.

Esse recurso está disponível apenas em sessões que utilizam o Media Router da Video API da Vonage (sessões com o modo de mídia definido como “routed”), e não em sessões com o modo de mídia definido como “relayed”. (Consulte O OpenTok Media Router e os modos de mídia).

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

Aviso sobre desativação de vídeo suspenso

É chamado quando o Media Router da Video API da Vonage determina que a qualidade do stream melhorou a ponto de a desativação do vídeo não representar um risco imediato.

Esse recurso está disponível apenas em sessões que utilizam o Media Router da Video API da Vonage (sessões com o modo de mídia definido como “routed”), e não em sessões com o modo de mídia definido como “relayed”. (Consulte O OpenTok Media Router e os modos de mídia).

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 assinante é iniciada (quando anteriormente não havia vídeo) ou 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 é detectado um evento relacionado à qualidade no lado do assinante.

Este evento é acionado quando ocorrem alterações significativas na qualidade do fluxo de vídeo do assinante, como uma interrupção detectada no vídeo (pausa) ou uma mudança de codec.

A implementação atual só aciona esse evento em caso de interrupções de vídeo ou mudanças de codec. Os travamentos são monitorados internamente e refletidos nas estatísticas, mas não acionam esse evento individualmente devido à sua curta duração e alta frequência. Uma chamada de retorno é acionada somente quando uma pausa (sem quadro renderizado por 5 segundos ou mais) é detectada, pois isso representa uma interrupção mais significativa na reprodução.

O VideoReason O valor especifica a causa do evento e segue esta ordem de prioridade: VideoInterruption, CodecChange.

Este evento difere de Vídeo desativado e Compatível com vídeo na medida em que relata alterações relacionadas à qualidade, em vez de simples transições de início/fim de faixa. O Vídeo desativado e Compatível com vídeo Os eventos indicam quando a trilha de vídeo do assinante foi desativada ou ativada (por exemplo, devido a um recurso alternativo de áudio ou a atualizações nas propriedades do stream). Em contrapartida, este evento fornece informações de diagnóstico sobre as causas da degradação da qualidade, tais como travamentos, contagem de pausas e estatísticas atualizadas de vídeo.

Este evento considera qualquer interrupção de vídeo com duração de cinco segundos ou mais. Em situações como o recurso de áudio alternativo ou a desativação do vídeo, a interrupção também é registrada como uma pausa nas estatísticas, e um evento correspondente de alteração de qualidade pode ser gerado.

Os aplicativos podem utilizar esse evento para lidar com questões de qualidade, como atualizar indicadores da interface do usuário, registrar dados de telemetria ou notificar os usuários.