Application de référence de la Video API pour ordinateur de bureau (Web) Release Notes

Ajouté

• Paramètres de vidéo et de partage d'écran améliorés — Sections distinctes pour la caméra et le partage d'écran, avec des réglages indépendants pour la résolution, la fréquence d'images, le débit binaire et la priorité du codec, ainsi qu'un partage d'écran adaptatif. Ajout de l'optimisation du contenu, de la duplication locale de la caméra et d'un bouton permettant d'afficher ou de masquer les informations de résolution et de fréquence d'images. Les modifications apportées au codec et à la scalabilité du partage d’écran s’appliqueront lors du prochain partage.
• Surface de partage d'écran préférée — Ajout d'un paramètre permettant de définir une surface par défaut dans la fenêtre de sélection du partage du navigateur, par exemple l'écran entier, une fenêtre ou un onglet du navigateur.
• Commandes de traitement audio — Ajout dans les paramètres audio des commandes WebRTC d'annulation de l'écho, de suppression du bruit, de contrôle automatique du gain et de suppression avancée du bruit de Vonage.
• Amélioration de la visibilité — Ajout de statistiques sur l'état du réseau, en plus des statistiques relatives aux médias des éditeurs et des abonnés.
• Récupération automatique des enregistrements après la migration du serveur — Permet la migration des sessions et la reprise automatique de l'enregistrement après la rotation des serveurs, sans avoir à demander à nouveau le consentement des participants qui l'ont déjà donné. Nécessite la prise en charge par la plateforme et la configuration des webhooks de session/d'archivage. Les sous-titres ne sont pas automatiquement relancés. Guide de migration des sessions
• Authentification Okta : ajout d'une authentification Okta facultative avec introspection des jetons « bearer » et d'un flux de connexion via navigateur utilisant le code d'autorisation OAuth 2.0 avec PKCE. Les jetons d'accès du navigateur sont conservés côté serveur, tandis que des cookies de session HttpOnly opaques gèrent les sessions du navigateur en toute sécurité. Les utilisateurs non authentifiés sont automatiquement redirigés vers la page de connexion lorsque l'authentification est activée. L'authentification reste désactivée par défaut.
• Localisation en japonais — Ajout de la prise en charge de l'interface utilisateur en japonais et achèvement des traductions manquantes.

Fixe

• L'expiration des jetons a été corrigée pour utiliser les secondes UNIX. Les jetons de connexion à la session expirent désormais au bout de 24 heures, et les entrées du client ne peuvent plus remplacer les rôles ou la durée d'expiration des jetons gérés par le serveur.
• Les en-têtes sensibles des requêtes et des réponses, ainsi que les champs imbriqués des journaux client, ont été masqués avant leur enregistrement ou leur transfert.
• On a empêché les gestionnaires asynchrones /v2/hooks défaillants de provoquer un plantage du backend.
• Correction d'un problème de duplication des statistiques par abonné, isolation des statistiques par abonné, et ajout d'informations sur la fréquence d'images mesurée et la résolution d'encodage.
• Correction du chargement des images d'arrière-plan personnalisées en environnement de production et suppression de l'effet actif lorsque l'image personnalisée est supprimée.
• Correction des vérifications de disponibilité des effets vidéo et de la fonctionnalité de partage d'écran sur Zoom ; séparation de la vérification de la disponibilité du test réseau avant l'appel de la prise en charge du processeur multimédia.
• On a évité que les clics accidentels ou les clics en arrière-plan soient interprétés comme un refus de consentement à l'enregistrement.
• Correction des états vides en double au niveau de la sortie audio et harmonisation de l'affichage de l'icône du microphone.
• Les traductions manquantes en allemand, espagnol, espagnol du Mexique et italien ont été ajoutées ; les codes régionaux de langue des navigateurs ont été harmonisés.
• Les noms des participants au partage d'écran, traduits selon les paramètres régionaux, ont été rétablis.
• Correction de l'affichage tronqué des noms des participants dans les réactions par emojis et localisation des erreurs de délai d'expiration lors du test de connexion avant l'appel, avec un délai d'expiration par défaut plus long.
• Configuration du front-end : utilisez le fichier app-config.json et exécutez la commande `yarn sync:env`. Le fichier env.sh généré ne doit pas être modifié directement.
• Thèmes personnalisés : migrez le fichier designTokens.json vers le format theme.json restructuré. Les noms des jetons de thème ont également changé. Guide de configuration
• Node.js : la plage de versions prises en charge est désormais ^22.13.0 || >=24.
• Dépendances : mise à jour du Vonage Client SDK de la version 2.34.0 à la version 2.35.1, de la bibliothèque network-test de la version 5.0.0 à la version 5.1.2, React Router de la version 6.30.3 à la version 7.18.2, et la bibliothèque de mise en page OpenTok de la version 5.5.0 à la version 5.5.1, ainsi que d'autres mises à jour de dépendances.

Problèmes connus

La liste des problèmes connus peut être consultée ici.

Nouvelles fonctionnalités

Paramètres avancés : contrôles de qualité et observabilité

Une nouvelle boîte de dialogue dotée d'onglets dédiés offre aux utilisateurs un contrôle total sur la configuration des médias et la surveillance en temps réel.

Paramètres vidéo

Configurer :

• Résolution
• Taux de rafraîchissement
• Débit binaire personnalisé
• Priorité des codecs (VP8, VP9, H.264)

Paramètres audio

Commande :

• Mode de débit binaire
• Opus DTX
• Solution de secours audio « émetteur/abonné »

Table ronde sur l'observabilité

Écran :

• État des cours d'eau
• Indicateurs de qualité en temps réel

API VideoHandler v2

A lancé un nouveau /v2 routeur backend optimisé par createVideoHandler, avec des points de terminaison de webhooks pour :

• Événements du cycle de vie de la session
• Légendes des événements du cycle de vie
• Événements liés au cycle de vie des archives

Abstraction de la clé de session

Basé sur le JWT SessionKey remplace désormais « raw » sessionId au niveau de la couche de gestion des sessions en arrière-plan, ce qui permet d'améliorer :

• Sécurité
• Cohérence

Téléchargement groupé de journaux

Ajout d'un nouveau /client-logs/batch point de terminaison qui accepte un tableau d'événements de journalisation et les transmet en une seule requête, ce qui réduit la charge liée à la journalisation à haute fréquence.

Synchroniseur de loggers

Ajout d'un nouveau composant qui se synchronise automatiquement :

• Identifiant utilisateur
• ID de la session
• ID de connexion

dans le contexte du journaliseur du front-end, garantissant ainsi une corrélation cohérente des journaux.

Système de notifications réutilisables

Ajouté :

• NotificationsContainer
• Fournisseur de journalisation d'exécution

afin de mettre en place un système unifié pour l'affichage des notifications au sein de l'application.

Personnalisation du thème de l'interface utilisateur

Ajouté :

• designTokens.json
• yarn sync:theme-tokens

pour permettre la personnalisation de l'apparence visuelle dans l'ensemble de l'application.

Configuration de l'hôte vidéo Vonage

Ajout de la prise en charge de la VONAGE_VIDEO_HOST variable d'environnement, permettant à l'application de se connecter à un point de terminaison personnalisé de la Video API de Vonage.

Notification « Caméra indisponible »

Les utilisateurs reçoivent désormais une notification lorsque leur caméra devient indisponible au cours d'une session en cours.

Améliorations

Documentation sur l'environnement configurable

Le fichier README a été enrichi d'une documentation complète couvrant les points suivants :

• Personnalisation de l'interface utilisateur
• Options de configuration de l'environnement

Mise à niveau vers Material UI v9

L'application a été mise à niveau vers Material UI (MUI) v9, ce qui permet de bénéficier des dernières améliorations apportées à la bibliothèque de composants, de fonctionnalités de personnalisation accrues, de mises à jour en matière d'accessibilité et d'un support à long terme du framework.

Sécurité

En-têtes de sécurité Helmet et limitation du débit

Renforcement de la sécurité du backend grâce à :

• Ajout d'en-têtes de sécurité Helmet
• Présentation du middleware de limitation de débit Express
• Réparation trust proxy configuration visant à empêcher l'usurpation d'adresse IP

Fixe

• Le nom du participant au partage d'écran n'est pas toujours visible
• L'icône de suppression des effets d'arrière-plan n'est pas visible
• L'activation/la désactivation des sous-titres ne fonctionne pas correctement dans certains flux
• Cas limite lié à la non-création d'un abonné Vonage, provoquant des erreurs non gérées
• L'application ne parvient pas à détecter les blocages liés aux autorisations d'accès au microphone au niveau du système d'exploitation
• Le point de terminaison du rapport de retour d'information renvoie des erreurs 500
• La vue du partage d'écran local n'est pas masquée lors du partage de l'écran entier (ce qui évite un effet de miroir infini)
• Marges de mise en page incorrectes dans le composant « Goodbye » sur les petites fenêtres d'affichage

Problèmes connus

La liste des problèmes connus peut être consultée ici.

Ajouté

• Amélioration de l'interface utilisateur du sélecteur de caméra dans la salle d'attente afin de mieux gérer les cas où aucun appareil photo n'est disponible.
• Ajout d'un indicateur d'avertissement pour l'état de l'enregistrement et de la transcription.
• Mise en œuvre de l'intégration du backend Gollum pour les événements des clients.
• Introduction du composant intégrable Vera Room.
• Mise à jour de l'icône dans les effets vidéo.
• Ajout de la prise en charge de la langue allemande avec des traductions complètes.
• Affichage des versions de l'application et du SDK dans le pied de page.
• Config.json est maintenant intégré au moment de la construction à partir de vcrBuild.env.sh, il n'y a plus de dépendance au moment de l'exécution.

Fixe

• Correction des marges de mise en page dans le composant GoodBye pour une meilleure réactivité.
• L'indication de l'enregistrement est toujours visible.
• Suppression des journaux d'avertissement inutilisés de l'éditeur.
• Masque l'option Effets vidéo dans MenuMoreOptions sur les navigateurs non pris en charge.
• Prévention des zooms avant et arrière dans les navigateurs non pris en charge (Firefox et Safari).

Problèmes connus

La liste des problèmes connus peut être consultée ici.

Ajouté

• Ajout d'un lien vers le support multiplateforme dans le README.
• Implémentation de makeRoomContextWrapper pour composer tous les fournisseurs liés à la salle pour les tests unitaires.
• Remplacement des crochets de contexte et de session simulés dans les tests unitaires.
• Introduction d'une base initiale pour le système d'enregistrement.
• Refonte de la gestion des périphériques avec des crochets unifiés et une utilisation standardisée.
• Ajout d'une bibliothèque commune avec des fonctions utilitaires partagées dans l'application.
• Mise à jour d'Axios vers la dernière version.
• Mise à jour du README avec la nouvelle marque Vonage et une section de bienvenue.

Fixe

• Mise à jour de la couleur du texte d'erreur dans FormSubmitted et ajustement de la couleur de la barre d'outils pour le mode sombre.
• Correction d'un problème où les noms des appareils étaient tronqués de manière incorrecte.
• Ajout d'un rembourrage dans les vues de l'orateur actif et du partage d'écran.
• Correction d'un problème où l'onglet émotions ne se fermait pas automatiquement dans la vue réduite.
• Résolution d'un problème de TIMEOUT empêchant les éditeurs de s'abonner à d'autres utilisateurs.
• Correction du désalignement entre l'épingle de l'utilisateur et l'icône du microphone.
• Activation du défilement vertical sur les écrans mobiles.
• Correction des boutons de test de qualité du réseau avant appel ("Fermer" et "Arrêter le test") ayant un comportement identique.
• Ajout d'un rembourrage autour du composant vidéo pour les largeurs d'écran comprises entre 900px et 1150px.
• Suppression du code inutilisé de l'interface utilisateur de la bibliothèque.
• Correction des problèmes de prévisualisation des vidéos dans Firefox.
• Les noms d'utilisateur restent visibles sur les fonds blancs.
• Correction d'un problème où la caméra de prévisualisation restait allumée alors qu'elle était éteinte.

Cette version se concentre sur les améliorations suivantes de l'UX et de l'UI :

• Introduction d'une nouvelle bibliothèque de jetons d'interface utilisateur sémantique pour améliorer la cohérence de la conception.
• Mise à jour de la page d'accueil.
• L'en-tête (qui comprend désormais un sélecteur de langue) et le pied de page ont été redessinés.
• Amélioration de l'expérience dans les salles d'attente et de réunion.
• Adieu réactualisé et pages de navigateur non prises en charge.

Ajouté

• Ajout d'un test de réseau préalable à l'appel dans la salle d'attente.
• Mise en place de la fonctionnalité "Push-to-Talk" dans la salle de réunion.
• Activation du basculement de l'appareil photo sur les appareils mobiles.
• Ajout du filtrage de la liste des participants dans la salle de réunion.
• Ajout des instructions GitHub Copilot au dépôt.

Fixe

• Amélioration de la qualité du code grâce à des vérifications TypeScript plus strictes, à un linting amélioré et à une meilleure couverture des tests unitaires.
• Augmentation de la fiabilité des tests et introduction d'un nouveau contexte de configuration de l'application pour la réactivité cadrée.
• Migration du référentiel vers Nx, permettant des constructions plus rapides grâce à une mise en cache intelligente et à l'orchestration des tâches.
• Correction de CVE-2025-55182.
• Les paramètres de l'appareil photo et de l'audio sont désormais conservés après le rechargement de la page.
• Correction de la détection automatique des caméras lorsqu'une caméra devient disponible pendant une réunion en cours.
• Mise à jour du SDK vidéo de Vonage à la version 2.32.1.
• Les utilisateurs sont redirigés vers la salle d'attente si aucun nom d'utilisateur n'est fourni lors de l'entrée dans la salle de réunion.
• Correction du zoom pour qu'il soit entièrement cliquable.