Nova Video API 2.33: Observabilidade do cliente e atualizações da plataforma

Introdução

Temos o prazer de anunciar o lançamento da Video API da Vonage versão 2.33. Essa atualização traz melhorias significativas na observabilidade do lado do cliente, introduz controles granulares para a qualidade de vídeo dos editores tanto na Web quanto em plataformas nativas e amplia o suporte da nossa plataforma para incluir Macs com Apple Silicon e o Debian 13.

Aqui está uma visão geral dos novos recursos e melhorias disponíveis nesta versão. Como sempre, recomendamos que você consulte as notas completas da versão para conhecer todas as alterações.

Observabilidade aprimorada do cliente

Obter insights sobre a experiência do usuário final é fundamental para manter sessões de Video de alta qualidade. A versão 2.33 apresenta um conjunto abrangente de novas métricas e eventos de qualidade para os SDKs de cliente. Essas melhorias permitem que os desenvolvedores monitorem o desempenho de emissores e assinantes de forma mais eficaz, proporcionando uma visibilidade mais profunda das condições da rede e dos dispositivos que afetam os terminais dos usuários. Esses novos pontos de dados foram projetados para ajudá-lo a identificar e solucionar proativamente problemas de qualidade em tempo real.

Para os editores, agora vocês têm acesso a:

• Métricas da camada Simulcast/SVC, incluindo dimensões dos quadros codificados, taxas de quadros de saída e taxa de bits para cada camada

• Informações sobre as limitações de qualidade que explicam exatamente por que a qualidade está sendo reduzida — seja por causa da largura de banda, da CPU ou de outras restrições

• Análises detalhadas da taxa de bits separando a carga útil real do Video da sobrecarga do protocolo

• Modo de escalabilidade e informações sobre codecs para otimização detalhada

Para os assinantes, as novas estatísticas incluem:

• Resolução e taxa de quadros decodificadas para entender exatamente o que os usuários estão recebendo

• Detecção de congelamento e pausa de Video com acompanhamento preciso da duração

• Métricas de desempenho de renderização para identificar gargalos na reprodução de mídia

Os eventos de alteração na qualidade do Video fornecem notificações em tempo real quando ocorrem mudanças significativas na qualidade, permitindo que você incorpore recursos proativos de gerenciamento de qualidade em seus Applications.

Essas melhorias na observabilidade permitem que você:

• Diagnosticar problemas de qualidade com mais rapidez e precisão

• Crie experiências adaptativas mais inteligentes com base em condições reais

• Ofereça um suporte melhor aos seus usuários finais com métricas concretas

• Otimizar o uso dos recursos de rede e de computação

Leia o Guia de Observabilidade do Cliente.

API de resolução e taxa de quadros preferidas pelo editor (JS Web)

Os aplicativos frequentemente exigem controle dinâmico sobre a qualidade do Video para se adaptarem a mudanças nos layouts da interface do usuário ou a restrições de largura de banda. O JavaScript Web SDK agora inclui novas APIs que permitem ajustar a resolução e a taxa de quadros preferidas de um editor após sua inicialização. Esse recurso permite que os desenvolvedores reduzam a resolução e a taxa de quadros de um cliente quando as configurações originais estiverem causando problemas de qualidade, garantindo a utilização eficiente dos recursos e que o vídeo publicado atenda aos requisitos específicos do aplicativo.

// Set preferred resolution
await publisher.setPreferredResolution({ width: 1280, height: 720 });

// Set preferred frame rate
await publisher.setPreferredFrameRate(30);

Observação importante: Embora seja possível definir valores preferenciais, a qualidade efetivamente fornecida será, em última instância, determinada pela largura de banda disponível da rede e pelos recursos do dispositivo. Os novos valores devem apresentar uma resolução ou taxa de quadros inferior à dos valores iniciais.

Saiba mais sobre Restrições de Video do Publisher.

Preferência de degradação do editor (SDKs nativos)

Para aplicativos móveis e de desktop executados em plataformas nativas, gerenciar o comportamento do Video em situações de carga elevada é fundamental para reter os usuários. 

Os SDKs nativos agora oferecem suporte a um parâmetro chamado “Preferência de degradação do editor”. Essa configuração permite especificar como o stream de um editor deve reagir a condições adversas de CPU ou rede — por exemplo, optando por reduzir a resolução para manter a taxa de quadros, ou vice-versa.

Esse controle é particularmente útil para otimizar o desempenho em dispositivos com recursos limitados, garantindo a melhor experiência possível mesmo quando os recursos são escassos ou quando certas applications têm uma necessidade muito específica de priorizar uma métrica em detrimento de outra. Por exemplo, uma aplicação da área da saúde pode preferir preservar a qualidade do Video em detrimento da qualidade do áudio em todas as situações, enquanto uma aplicação que transmite conteúdo de jogos ou esportes pode priorizar uma taxa de quadros consistente em vez da fidelidade visual.

Consulte o guia sobre Como definir a preferência de degradação do editor.

Suporte ampliado a plataformas

SDK do iOS no Mac (Apple Silicon)

Adicionamos oficialmente o suporte ao SDK do Vonage para iOS em computadores Mac equipados com Apple Silicon. Aproveitando as semelhanças arquitetônicas entre os chips móveis e de desktop da Apple, esta atualização oferece aos usuários e desenvolvedores de Mac uma opção robusta e nativa de SDK para a criação de Applications para macOS.

Veja a Visão geral do SDK do iOS.

Suporte ao Debian 13

Nosso suporte ao Linux continua a evoluir com a inclusão do Debian 13. Os desenvolvedores agora podem implantar a Video API da Vonage na versão mais recente do Debian, garantindo a compatibilidade com os padrões modernos de infraestrutura.

Recursos disponíveis para o público em geral (GA)

Estimativa do downlink do assinante

Anteriormente em fase beta, o recurso “Estimativa de Downlink do Assinante” já está disponível para o público em geral. Essas métricas de observabilidade fornecem uma estimativa da largura de banda disponível que um participante possui para receber tráfego de Video. Esses dados são essenciais para a implementação de uma lógica adaptativa que ajuste a qualidade da assinatura com base na capacidade real da rede do usuário.

Confira a documentação sobre Estatísticas do lado do remetente para observabilidade do cliente.

Google Chrome para iOS

Agora oferecemos suporte completo ao Google Chrome no iOS, garantindo uma experiência de Video consistente e confiável para os usuários que acessam seu aplicativo pelo Chrome em dispositivos móveis da Apple.

Introdução

Pronto para fazer a atualização? Veja aqui o que você precisa saber.

Instalação para JavaScript/Web:

npm install @vonage/client-sdk-video@2.33.0

Para SDKs nativos, acesse nossa documentação para obter instruções de instalação específicas para cada plataforma.

Conclusão

Esperamos que todas as métricas de qualidade adicionais e a capacidade de ajustar a qualidade dinamicamente ajudem você a criar aplicações de vídeo mais eficientes. Com acesso em tempo real a essas métricas, os desenvolvedores podem criar interações melhores com os usuários em suas aplicações.