https://a.storyblok.com/f/270183/1368x665/85024ee40f/25feb_dev-blog_client-sdk-v233_1368x665.png

Nouvelle API Video 2.33 : Observabilité du client et mises à jour de la plate-forme

Publié le February 19, 2026

Temps de lecture : 6 minutes

Introduction

Nous sommes heureux d'annoncer la sortie de la version 2.33 de l'API Video de Vonage. Cette mise à jour apporte des améliorations significatives à l'observabilité côté client, introduit des contrôles granulaires pour la qualité vidéo de l'éditeur sur les plates-formes Web et Native, et étend notre prise en charge des plates-formes pour inclure les Macs Silicon d'Apple et Debian 13.

Voici un aperçu des nouvelles fonctionnalités et des améliorations disponibles dans cette version. Comme toujours, nous recommandons de consulter les notes de version complètes pour tous les changements.

Amélioration de l'observabilité des clients

Il est essentiel de connaître l'expérience de l'utilisateur final pour maintenir des sessions vidéo de haute qualité. La version 2.33 introduit un ensemble complet de nouvelles mesures et d'événements de qualité pour les SDK clients. Ces améliorations permettent aux développeurs de surveiller plus efficacement les performances de l'éditeur et de l'abonné, en offrant une meilleure visibilité sur les conditions du réseau et des appareils qui affectent les terminaux des utilisateurs. Ces nouveaux points de données sont conçus pour vous aider à identifier de manière proactive et à résoudre les problèmes de qualité en temps réel.

Pour les éditeurs, vous avez maintenant accès à :

  • Métriques de la couche Simulcast/SVC, y compris les dimensions des images encodées, les fréquences d'images de sortie et le débit binaire pour chaque couche

  • Des informations sur la limitation de la qualité qui vous indiquent exactement pourquoi la qualité est réduite, qu'il s'agisse de la bande passante, de l'unité centrale ou d'autres contraintes.

  • Ventilation détaillée du débit binaire séparation de la charge utile vidéo réelle et de la surcharge du protocole

  • Mode d'extensibilité et informations sur les codecs pour une optimisation fine

Pour les abonnés, les nouvelles statistiques comprennent

  • Résolution décodée et fréquence d'images pour comprendre exactement ce que les utilisateurs reçoivent

  • Détection des arrêts sur image et des pauses vidéo avec suivi précis de la durée

  • Mesures des performances de rendu pour identifier les goulets d'étranglement dans la lecture des médias

Les événements de modification de la qualité vidéo fournissent des notifications en temps réel lorsque des modifications importantes de la qualité se produisent, ce qui vous permet d'intégrer des fonctions de gestion proactive de la qualité dans vos Applications.

Ces améliorations de l'observabilité vous permettent de

  • Diagnostiquer plus rapidement et plus précisément les problèmes de qualité

  • Créer des expériences adaptatives plus intelligentes basées sur des conditions réelles

  • Fournir une meilleure assistance à vos utilisateurs finaux grâce à des mesures concrètes

  • Optimiser l'utilisation du réseau et des ressources informatiques

Lire le Guide d'observabilité du client.

API de résolution préférée et de fréquence d'images de l'éditeur (JS Web)

Les applications ont souvent besoin d'un contrôle dynamique de la qualité vidéo pour s'adapter à l'évolution de la présentation de l'interface utilisateur ou aux contraintes de bande passante. Le JavaScript Web SDK comprend désormais de nouvelles API qui vous permettent d'ajuster la résolution et la fréquence d'images préférées d'un éditeur après son initialisation. Cette fonctionnalité permet aux développeurs d'abaisser la résolution et la fréquence d'images d'un client lorsque les paramètres d'origine posent des problèmes de qualité, garantissant ainsi une utilisation efficace des ressources et la conformité de la vidéo publiée aux exigences spécifiques de l'application.

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

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

Remarque importante : Bien que vous puissiez définir des valeurs préférentielles, la qualité réelle fournie sera finalement déterminée par la bande passante disponible sur le réseau et les capacités de l'appareil. Les nouvelles valeurs doivent correspondre à une résolution ou à une fréquence d'images inférieure aux valeurs initiales.

En savoir plus sur Contraintes de l'éditeur en matière de Video.

Préférence de dégradation de l'éditeur (SDK natifs)

Pour les applications mobiles et de bureau fonctionnant sur des plateformes natives, la gestion du comportement de la vidéo en cas de stress est vitale pour fidéliser les utilisateurs.

Les SDK natifs prennent désormais en charge le paramètre Publisher Degradation Preference (Préférence de dégradation de l'éditeur). Ce paramètre vous permet de spécifier comment le flux d'un éditeur doit réagir aux mauvaises conditions de l'unité centrale ou du réseau, par exemple en choisissant de dégrader la résolution pour maintenir la fréquence d'images, ou vice versa.

Ce contrôle est particulièrement utile pour optimiser les performances sur des appareils limités, pour garantir la meilleure expérience possible même lorsque les ressources sont limitées, ou lorsque certaines applications ont un besoin très spécifique de donner la priorité à une métrique plutôt qu'à une autre. Par exemple, une application de soins de santé peut vouloir préserver en permanence la qualité vidéo au détriment de la qualité audio, tandis qu'une application qui diffuse des jeux ou du contenu sportif peut privilégier une fréquence d'images constante au détriment de la fidélité visuelle.

Voir le guide sur Définir la préférence de dégradation de l'éditeur.

Support élargi de la plate-forme

SDK iOS sur Mac (Apple Silicon)

Nous avons officiellement ajouté la prise en charge du SDK iOS de Vonage sur les machines Mac équipées de l'Apple Silicon. Tirant parti des similitudes architecturales entre le silicium mobile et le silicium de bureau d'Apple, cette mise à jour offre aux utilisateurs et aux développeurs Mac une option SDK robuste et native pour la création d'applications macOS.

Voir l'aperçu du Vue d'ensemble du SDK iOS.

Prise en charge de Debian 13

Notre support Linux continue d'évoluer avec l'ajout de Debian 13. Les développeurs peuvent désormais déployer l'API Video de Vonage sur la dernière distribution de Debian, ce qui garantit la compatibilité avec les normes d'infrastructure modernes.

Fonctionnalités généralement disponibles (GA)

Estimation de la liaison descendante de l'abonné

Précédemment en version bêta, la fonction Subscriber Downlink Estimation est désormais disponible de manière générale. Ces mesures d'observabilité fournissent une estimation de la bande passante disponible dont dispose un participant pour recevoir du trafic vidéo. Ces données sont essentielles pour mettre en œuvre une logique adaptative qui ajuste la qualité de l'abonnement en fonction de la capacité réelle du réseau de l'utilisateur.

Consultez la documentation pour Statistiques côté émetteur pour l'observabilité du client.

Google Chrome pour iOS

Nous assurons désormais une prise en charge complète de Google Chrome sur iOS, ce qui garantit une expérience vidéo cohérente et fiable aux utilisateurs qui accèdent à votre application via Chrome sur les appareils mobiles Apple.

Pour commencer

Prêt à passer à la vitesse supérieure ? Voici ce qu'il faut savoir.

Installation pour JavaScript/Web :

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

Pour les SDK natifs, consultez notre documentation pour les instructions d'installation spécifiques à chaque plateforme.

Conclusion

Nous espérons que toutes les mesures de qualité supplémentaires et la possibilité d'ajuster la qualité à la volée vous aideront à créer des applications vidéo plus efficaces. Grâce à l'accès en temps réel à ces mesures, les développeurs peuvent créer de meilleures interactions avec les utilisateurs dans leurs applications.

Vous avez une question ou souhaitez partager ce que vous construisez ?

Restez connecté et tenez-vous au courant des dernières nouvelles, astuces et événements concernant les développeurs.

Partager:

https://a.storyblok.com/f/270183/384x384/3bc39cbd62/christankersley.png
Chris TankersleyRelations avec les développeurs Gestionnaire d'outils

Chris est le Developer Relations Tooling Manager et dirige l'équipe qui construit vos outils préférés. Il programme depuis plus de 15 ans dans différents langages et pour différents types de projets, depuis le travail avec les clients jusqu'aux systèmes à grande échelle et aux données volumineuses. Il vit dans l'Ohio, où il passe son temps avec sa famille et joue à des jeux vidéo et TTRPG.