Nueva Video API 2.33: Observabilidad del cliente y actualizaciones de la plataforma

Introducción

Nos complace anunciar el lanzamiento de Vonage Video API 2.33. Esta actualización aporta mejoras significativas a la observabilidad del lado del cliente, introduce controles granulares para la calidad de vídeo del editor en plataformas web y nativas, y amplía nuestra compatibilidad de plataformas para incluir Apple Silicon Macs y Debian 13.

He aquí un resumen de las nuevas funciones y mejoras disponibles en esta versión. Como siempre, recomendamos consultar las notas de la versión completa para conocer todos los cambios.

Mayor observabilidad de los clientes

Conocer la experiencia del usuario final es fundamental para mantener sesiones de vídeo de alta calidad. La versión 2.33 introduce un amplio conjunto de nuevas métricas y eventos de calidad para los SDK de cliente. Estas mejoras permiten a los desarrolladores supervisar el rendimiento del editor y del suscriptor con mayor eficacia, proporcionando una visibilidad más profunda de las condiciones de la red y del dispositivo que afectan a los puntos finales del usuario. Estos nuevos puntos de datos están diseñados para ayudarle a identificar y solucionar problemas de calidad de forma proactiva y en tiempo real.

Para los editores, ahora tienes acceso a:

• Métricas de las capas Simulcast/SVC, incluidas las dimensiones de los fotogramas codificados, las frecuencias de fotogramas de salida y la tasa de bits de cada capa

• Información sobre las limitaciones de calidad que le indican exactamente por qué se está reduciendo la calidad, ya sea por el ancho de banda, la CPU u otras limitaciones.

• Desglose detallado de la tasa de bits separación de la carga útil de vídeo real de la sobrecarga del protocolo

• Modo de escalabilidad e información del códec para una optimización detallada

Para los abonados, las nuevas estadísticas incluyen:

• Resolución y frecuencia de imagen descodificadas para saber exactamente lo que reciben los usuarios

• Detección de congelación y pausa de Video con seguimiento preciso de la duración

• Métricas de rendimiento de renderizado para identificar cuellos de botella en la reproducción multimedia

Los eventos de cambio de calidad de Video proporcionan notificaciones en tiempo real cuando se producen cambios significativos en la calidad, lo que le permite incorporar funciones de gestión proactiva de la calidad en sus aplicaciones.

Estas mejoras de la observabilidad le permiten:

• Diagnostique los problemas de calidad con mayor rapidez y precisión

• Crear experiencias adaptativas más inteligentes basadas en condiciones reales

• Ofrezca una mejor asistencia a sus usuarios finales con métricas concretas

• Optimizar el uso de los recursos de red y computación

Lea la Guía de Observabilidad del Cliente.

API de resolución y frecuencia de imagen preferidas por el editor (JS Web)

Applications often require dynamic control over video quality to adapt to changing UI layouts or bandwidth constraints. El JavaScript Web SDK incluye ahora nuevas API que permiten ajustar la resolución y la frecuencia de imagen preferidas de un editor una vez inicializado. Esta función permite a los desarrolladores reducir la resolución y la frecuencia de imagen de un cliente cuando los ajustes originales están causando problemas de calidad, lo que garantiza una utilización eficiente de los recursos y que el vídeo publicado cumpla los requisitos específicos de la aplicación.

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

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

Nota importante: Aunque puede establecer los valores preferidos, la calidad real suministrada vendrá determinada en última instancia por el ancho de banda de red disponible y las capacidades del dispositivo. Los nuevos valores deben tener una resolución o una frecuencia de imagen inferiores a los valores iniciales originales.

Más información Restricciones de publicación de Video.

Preferencia de degradación del editor (SDK nativos)

Para las aplicaciones móviles y de escritorio que se ejecutan en plataformas nativas, gestionar cómo se comporta el vídeo bajo tensión es vital para retener a los usuarios.

Los SDK nativos admiten ahora un parámetro de preferencia de degradación del editor. Este parámetro permite especificar cómo debe reaccionar el flujo de un editor ante condiciones deficientes de la CPU o de la red, por ejemplo, optando por degradar la resolución para mantener la frecuencia de imagen, o viceversa.

Este control es especialmente útil para optimizar el rendimiento en dispositivos con restricciones, garantizar la mejor experiencia posible incluso cuando los recursos son limitados, o cuando determinadas aplicaciones tienen una necesidad muy específica de priorizar una métrica sobre otra. Por ejemplo, una aplicación de atención sanitaria puede querer preservar en todo momento la calidad de vídeo frente a la de audio, mientras que una aplicación que transmite contenidos de juegos o deportes puede favorecer una frecuencia de imagen constante frente a la fidelidad visual.

Consulte la guía sobre Configuración de la preferencia de degradación del editor.

Mayor compatibilidad con plataformas

SDK de iOS en Mac (Apple Silicon)

Hemos agregado oficialmente compatibilidad con el SDK de Vonage para iOS en equipos Mac equipados con Apple Silicon. Aprovechando las similitudes arquitectónicas entre el silicio móvil y de escritorio de Apple, esta actualización ofrece a los usuarios y desarrolladores de Mac una opción SDK nativa y sólida para crear aplicaciones macOS.

Ver el Descripción general del SDK de iOS.

Soporte Debian 13

Nuestra compatibilidad con Linux continúa evolucionando con la incorporación de Debian 13. Los desarrolladores ahora pueden implementar la Video API de Vonage en la distribución más reciente de Debian, lo que garantiza la compatibilidad con los estándares de infraestructura modernos.

Funciones generalmente disponibles (GA)

Estimación del enlace descendente del abonado

La función de estimación del enlace descendente del abonado, que hasta ahora estaba en fase beta, ya está disponible de forma general. Estas métricas de observabilidad proporcionan una estimación del ancho de banda disponible que tiene un participante para recibir tráfico de vídeo. Estos datos son esenciales para aplicar una lógica adaptativa que ajuste la calidad de la suscripción en función de la capacidad real de la red del usuario.

Consulte la documentación de Estadísticas del remitente para la observabilidad del cliente.

Google Chrome para iOS

Ahora ofrecemos compatibilidad total con Google Chrome en iOS, lo que garantiza una experiencia de vídeo coherente y fiable para los usuarios que accedan a su aplicación a través de Chrome en dispositivos móviles de Apple.

Primeros pasos

¿Preparado para actualizar? Esto es lo que necesitas saber.

Instalación para JavaScript/Web:

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

Para los SDK nativos, visite nuestra documentación para obtener instrucciones de instalación específicas para cada plataforma.

Conclusión

Esperamos que todas las métricas de calidad adicionales y la posibilidad de ajustar la calidad sobre la marcha te ayuden a crear aplicaciones de vídeo más eficientes. Con el acceso en tiempo real a estas métricas, los desarrolladores pueden crear mejores interacciones con los usuarios en sus aplicaciones.