SDK vidéo Javascript Release Notes

Fixe

• Correction d'un problème dû auquel le fait de changer de périphérique d'entrée audio (par exemple, en connectant un casque Bluetooth) peu après le démarrage de la session pouvait déclencher un audioAcquisitionProblem ce qui a entraîné une perte totale du son pour les participants à distance dès que la session est passée à une topologie acheminée.

• Correction d'un problème empêchant les applications s'exécutant dans un Chrome WebView sous Android d'accéder au test préalable à l'appel ou de rejoindre une visioconférence.

• Correction d'une définition TypeScript manquante : la constraints ce bien n'était pas inclus dans le GetUserMediaProperties interface dans ot.d.ts, ce qui entraîne un décalage par rapport au comportement réel du SDK lors de l'exécution.

Fixe

• Correction d'un problème : l'utilisation de la méthode `publisher.setPreferredResolution()` associée à un filtre d'arrière-plan (flou ou remplacement) entraînait une modification inattendue de la résolution publiée. Désormais, le publisher conserve la résolution prévue lorsqu'un filtre d'arrière-plan est appliqué.

• Correction d'un problème : lorsque la vidéo était désactivée puis réactivée (avec les appels successifs `publishVideo(false)` puis `publishVideo(true)`) alors qu'un filtre d'arrière-plan (flou ou remplacement) était actif, des images non filtrées pouvaient brièvement s'afficher pour les participants à distance. Le SDK garantit désormais que seules les images filtrées sont envoyées après la réactivation de la vidéo.

• Correction d'un changement introduit dans la version 2.34, dans laquelle la définition TypeScript de la méthode OT.hasMediaProcessorSupport() exigeait à tort un paramètre « mediaType ». Ce paramètre est désormais facultatif, ce qui rétablit la compatibilité avec le code existant qui appelle OT.hasMediaProcessorSupport() sans argument.

Ajouté

• Ajout de nouvelles informations sur l'état du réseau. Cette version ajoute de nouveaux indicateurs d'état du réseau à la fonctionnalité d'observabilité client, offrant ainsi une visibilité détaillée sur les performances du réseau et les indicateurs de qualité. Ces indicateurs complètent les statistiques relatives aux éditeurs et aux abonnés introduites dans la version 2.33.0 et aident les développeurs à surveiller de manière proactive les conditions réseau affectant la qualité vidéo, à diagnostiquer les problèmes de connectivité et à prendre des décisions éclairées concernant les ajustements potentiels. Pour plus d’informations, consultez cette documentation.

• Ajout de la prise en charge du flou d'arrière-plan et du remplacement d'arrière-plan sur Safari et Firefox. Cette version ajoute la prise en charge du flou d'arrière-plan et du remplacement d'arrière-plan sur Safari et Firefox. Cela garantit la cohérence des fonctionnalités sur tous les principaux navigateurs et appareils, répondant ainsi aux demandes des clients qui souhaitaient une prise en charge uniforme des effets d'arrière-plan sur toutes les plateformes. Pour vérifier la disponibilité des API de navigateur requises, le SDK utilise un web worker intégré. Ce web worker intégré peut déclencher des violations de la politique de sécurité du contenu (CSP) dans les applications qui appliquent une CSP stricte — en particulier celles qui n’incluent pas blob: et data: dans le worker-src ou child-src . Pour plus d'informations, voir cette documentation.

• Ajout de la prise en charge de la traduction des sous-titres en direct. Cette version ajoute la prise en charge de la traduction des sous-titres en direct, qui permet de traduire les sous-titres en temps réel lors des appels vidéo. Chaque participant peut choisir librement la langue de traduction de son choix. Cette fonctionnalité prend en charge l'ensemble des langues disponibles dans AWS Translate. Il s'agit d'une fonctionnalité en bêta privée : pour activer la traduction des sous-titres en direct pour votre projet, contactez-nous. Pour plus d’informations sur les sous-titres en direct, consultez cette documentation.

Fixe

• Cette version corrige un problème de synchronisation où la définition d'un connecteur de processeur de média immédiatement après la création d'un abonné pouvait échouer. Le SDK attend désormais que le flux soit disponible avant d'appliquer le connecteur.

• Cette version corrige un problème où les flux ne parvenaient pas à s'abonner dans les sessions où le chiffrement de bout en bout et la connexion unique étaient tous deux activés.

• Cette version corrige un problème lié à la gestion de la reconnexion automatique qui pouvait entraîner des réinitialisations de connexion inutiles lors de la récupération du réseau. Les reconnexions sont désormais plus fiables et n'interrompent pas les connexions stables entre pairs.

• Cette version corrige une condition de concurrence dans laquelle l'appel à subscribeToVideo(true) immédiatement après l'initialisation de l'abonné pourrait échouer si la piste vidéo n'avait pas encore été reçue.

• Cette version corrige des problèmes liés à un calcul erroné de la perte de paquets et au fait que les événements de repli audio ne se déclenchaient pas dans certaines situations. Ces corrections ont été identifiées lors de la mise en œuvre de la informations sur l'état du réseau fonctionnalité, car les événements de basculement audio constituent l'un des critères utilisés pour évaluer l'état du réseau. Ces deux corrections permettent d'obtenir un comportement de basculement audio plus précis et plus fiable.

Exigences

La bibliothèque OpenTok.js est actuellement prise en charge dans :

• Electron (dernière version)
• Google Chrome (dernière version)
• Google Chrome pour Android (dernière version)
• Prise en charge bêta de Google Chrome pour iOS (dernière version)
• Firefox (dernière version)
• Firefox pour Android (dernière version)
• Prise en charge de la version bêta de Firefox pour iOS (dernière version)
• Microsoft Edge versions 79+ pour Windows et macOS (versions de Edge basées sur Chromium)
• Safari 11+ sur macOS et iOS. Pour plus d'informations sur l'interopérabilité vidéo et d'autres questions, consultez le site web de la Commission européenne. Prise en charge du navigateur Safari page.
• Opera (dernière version)
• Samsung (dernière version)
• WebView Android API niveau 36+
• WebView sur iOS 18.6+

Important : OpenTok.js version 2.16 était la dernière version à supporter le plugin pour Internet Explorer. La version 2.16 d'OpenTok.js a été supprimée en mai 2020 pour l'environnement Standard et en juin 2020 pour l'environnement Enterprise.

La bibliothèque OpenTok.js utilise le port 443. Le port 443 doit être ouvert sur le réseau du client.

Problèmes connus

Problèmes liés au navigateur

Safari

• La qualité vidéo peut sembler réduite lors de la diffusion en continu du contenu du « canvas », en raison d'une réduction interne de la résolution, de la gestion du rapport de pixels de l'appareil ou de l'encodage WebRTC de Safari. Voir ceci Bogue de WebKit.
• Le chiffrement de bout en bout ne fonctionne pas lorsque les outils de développement sont ouverts dans les navigateurs basés sur WebKit (Safari sous macOS/iOS, Chrome sous iOS). Nous travaillons actuellement à la résolution de ce problème.
• Le SDK JavaScript Video 2.27 et les versions ultérieures ne sont pas pris en charge par Safari 14 et les versions antérieures.
• Le son des nouveaux abonnés est coupé tant que vous n'avez pas mis l'onglet du navigateur au premier plan. Le fait de basculer sur cet onglet rétablit le son. Voir ici Bogue de WebKit.
• Dans Safari 17.0 et versions ultérieures, le paramètre de résolution vidéo n'est pas pris en compte pour les vidéos de partage d'écran. La résolution obtenue est toujours de 640 × 360. Voir ceci Bogue de WebKit.
• Lors de l'appel de OT.initPublisher() Pour initialiser un éditeur de partage d'écran sans gestionnaire de gestes utilisateur, vous risquez de recevoir une InvalidAccessError. C'est comportement attendu de Safari.
• Sous iOS 16.4 ou une version ultérieure, lorsque la fonction « Relais privé iCloud » est activée, les utilisateurs peuvent rencontrer des déconnexions lors des sessions relayées. Consultez cette page Bogue de WebKit.
• Le son et la vidéo peuvent être interrompus après un appel entrant sur Safari sous iOS. Après avoir répondu à un appel et repris une session, le son et la vidéo provenant de l'appareil iOS peuvent être interrompus. Consultez les bogues WebKit suivants : #213853, #219318.
• La qualité audio des flux diffusés depuis Safari sur iOS/iPadOS peut se dégrader au fil du temps, ce qui peut se traduire par des grésillements ou des distorsions. Voir cet article Bogue de WebKit.

iOS

• Pour les utilisateurs de la version navigateur sur iOS, le volume sonore peut parfois être incorrect. Nous travaillons actuellement à la résolution de ce problème. Consultez cette page Bogue de WebKit.
• La vidéo présente des saccades lorsque l'on change l'orientation de l'appareil ou que l'on redimensionne la vidéo sous iOS 17 et versions ultérieures. Voir ici Bogue de WebKit.
• La vidéo s'affiche initialement avec une résolution incorrecte dans un éditeur vidéo sous iOS 17 et versions ultérieures, ce qui provoque un scintillement visible lors du redimensionnement. Voir ceci Régression WebKit.
• Des emojis apparaissent de manière inattendue dans les vidéos sous iOS 17 en raison d'une décision d'Apple Réactions fonctionnalité. Les utilisateurs finaux doivent la désactiver manuellement : ouvrez le Centre de contrôle → appuyez sur « Effets vidéo » → appuyez sur « Réactions ».

Chrome / Chromium

• Sous Windows, avec les pilotes audio Intel Smart Sound Technology, un éditeur peut ne pas envoyer un audioInputDeviceChanged problème lors du changement de périphérique d'entrée audio. Le son continuera toutefois à être acheminé correctement. Nous travaillons actuellement à la résolution de ce problème.
• Fermer le couvercle de l'ordinateur portable pendant la publication entraîne la destruction de l'éditeur. Voir ici Bogue de Chromium.
• La suppression de l'écho est désactivée avec une entrée audio stéréo dans Chrome 73 et versions ultérieures. Voir ici Problème avec Chrome.
• La publication n'est pas prise en charge sur http pages (à l'exception de http://localhost). Les pages doivent être diffusées via https.
• La vidéo peut présenter des scintillements lors de la diffusion en continu avec videoType fixé à "custom" lorsque le contenu vidéo ne change pas beaucoup. Réglage videoContentHint à text ou detail atténue le problème. Voir le Guide des paramètres vidéo.

Firefox

• Le réglage de la fréquence d'images n'a aucun effet dans Firefox sous macOS lorsque l'on utilise la caméra FaceTime intégrée. Voir ceci Bug Mozilla.
• Paramètres audioBitrate en OT.initPublisher() n'a aucun effet dans Firefox. Voir ceci Bug Mozilla.
• Sous Android 13, les autorisations d'accès au microphone et à la caméra de Firefox ne prennent effet qu'après un redémarrage de l'appareil.
• Sous Android 13, il se peut que la résolution vidéo ne s'ajuste pas correctement lors d'un changement d'orientation. Voir ceci Régression Mozilla.

Android

• Sous Android 12 et 13, Chrome nécessite d'utiliser la fonction « Volume multimédia » pour régler le volume, et non le curseur de volume du téléphone. Voir ceci Bogue de Chromium.
• Dans WebView Android, lorsque l'application passe en arrière-plan (changement d'application ou appel entrant), la vidéo de l'éditeur s'arrête et ne redémarre pas lorsque l'application revient au premier plan.

macOS

• Des emojis apparaissent de manière inattendue dans les vidéos sous macOS 14 (Sonoma) en raison d'une décision d'Apple Réactions fonctionnalité. Pour la désactiver : cliquez sur l'icône verte représentant un appareil photo dans la barre de menu → désélectionnez « Réactions ».

Questions générales

• Les accessDialogOpened l'événement peut être déclenché par erreur lors de l'appel de OT.getUserMedia(), même si aucune boîte de dialogue d'accès ne s'est affichée.
• Dans certains cas, lors du partage d'une présentation Google Slides en mode « onglet », la vidéo s'affiche avec des bandes noires lorsque le format d'image défini par l'auteur est de 4:3. Ce phénomène ne se produit pas lors du partage d'écran de la présentation dans son intégralité.
• Chez certains utilisateurs de Firefox mobile, l'orientation de l'appareil peut perturber la diffusion de la vidéo de l'éditeur. Voir ceci Bug Mozilla.

Problèmes corrigés

• Correction d'une fuite de mémoire affectant les sessions de longue durée avec plusieurs participants.
• Correction d'une erreur de définition TypeScript dans laquelle la propriété publisher stats était incorrectement nommée. transport au lieu de transportStats.

Nouvelles fonctionnalités et changements

• Ajout de nouvelles statistiques pour les diffuseurs et les abonnés, ainsi que d'événements liés aux changements de qualité vidéo. Cette version intègre de nouvelles statistiques pour les diffuseurs et les abonnés, notamment : des indicateurs relatifs à la couche vidéo pour la diffusion simultanée (simulcast) et le SVC, ainsi que des statistiques de transport pour les diffuseurs ; le suivi des arrêts/pauses vidéo et des indicateurs de décodage pour les abonnés ; et des événements liés aux changements de qualité vidéo tant pour les diffuseurs que pour les abonnés. Pour plus d'informations, consultez cette documentation.

• Ajout de la prise en charge complète des statistiques réseau des expéditeurs dans les sessions vidéo. Cette version ajoute la prise en charge complète des statistiques réseau des expéditeurs pour les abonnés participant à des sessions vidéo (cette fonctionnalité était auparavant en version bêta). Pour plus d'informations, consultez cette documentation.

• Ajout de la prise en charge de la résolution et de la fréquence d'images préférées pour les éditeurs. Cette version intègre de nouvelles méthodes permettant de configurer la résolution et la fréquence d'images préférées pour les éditeurs, ce qui vous permet d'ajuster de manière dynamique la qualité des vidéos sortantes, sans dépasser la résolution ou la fréquence d'images initialement spécifiées lors de l'initialisation de l'éditeur. Pour plus d'informations, consultez cette documentation.

• OpenTok.js prend désormais entièrement en charge Google Chrome pour iOS. Pour plus d'informations, consultez cette documentation.

• Nous avons supprimé la fonction video.frameRate dans les objets de statistiques renvoyés par Subscriber.getStats() gestionnaire d'achèvement. Cette propriété est obsolète et sera supprimée à l'avenir. Veuillez utiliser à la place la video.decodedFrameRate à la place. Pour plus d'informations, voir cette documentation.

Problèmes corrigés

• Résolution d'un problème où les définitions TypeScript pour le Bitrate Max de l'éditeur n'étaient pas incluses dans les versions précédentes.
• Correction d'une fuite de mémoire dans la logique de gestion de websocket pour le protocole de signalisation.
• Correction d'un problème où les options de traitement audio (contrôle du gain, annulation de l'écho, etc.) n'étaient pas appliquées correctement dans certains scénarios.
• Correction de problèmes liés à la gestion des changements de périphériques d'entrée audio, notamment la détection du changement de périphérique par défaut et la précision du suivi des périphériques.