Client SDK

Important
Mise à jour du SDK Web. Il est désormais servi à partir de https://video.standard.vonage.com/v2/js/opentok.min.js. Problèmes corrigés dans Safari 15.4 et 15.5. Les versions 15.4 et 15.5 de Safari (livrées avec iOS 15.4 et 15.5 et macOS 12.3 et 12.4) corrigent les problèmes suivants, qui pourraient affecter les applications utilisant OpenTok.js (dans Safari) :
Problèmes audio lors de l'utilisation de certains modèles de casques Bluetooth. Sur certains modèles d'oreillettes Bluetooth, le son peut s'interrompre. Il s'agit d'une Bogue de WebKit est corrigé dans Safari 15.4.
Problèmes d'écho lors du changement de microphone dans macOS Safari. Le changement du microphone utilisé par un éditeur pouvait entraîner un écho de l'audio de l'éditeur. L'écho n'apparaissait pas du côté de l'abonné. Cette situation est due au fait que l'abonné n'a pas d'écho. Bogue de WebKit est corrigé dans Safari 15.5.
Bug critique publiant de la vidéo H.264 dans les sessions routées dans iOS 15.1. Dans iOS 15.1, la publication de vidéos H.264 dans les sessions routées échouait. Ce problème a été résolu par la mise en place d'un système de gestion de la vidéo. Bogue de WebKit a été corrigée dans Safari 15.4. Le volume audio est faible dans iOS Safari. Le présent Bogue de WebKit est corrigé dans Safari 15.4.

Cryptage de bout en bout : Dans OpenTok.js 2.27.0, le cryptage de bout en bout ne fonctionnera pas avec les clients utilisant une version antérieure d'OpenTok.js. avec les clients utilisant une version antérieure d'OpenTok.js. Lorsque vous mettez à jour votre application pour utiliser OpenTok.js 2.27.0+, assurez-vous que tous les clients utilisent OpenTok.js 2.27.0+ si l'application utilise le cryptage de bout en bout. si l'application utilise le chiffrement de bout en bout.

Vue d'ensemble

Toutes les Applications qui utilisent l'API Video de Vonage sont composées de deux parties :

  • Le côté client, qui utilise les SDK clients de Vonage Video et s'exécute dans le navigateur ou l'application mobile d'un utilisateur.
  • Le côté serveur, qui utilise la fonction SDKs du serveur vidéo de Vonage et s'exécute sur votre serveur pour transmettre les informations d'authentification au client

Le Client SDK pour la création d'applications basées sur le Web qui utilisent l'API Video de Vonage est le suivant OpenTok.js. Cette bibliothèque JavaScript fournit la plupart des fonctionnalités de base de votre application, y compris :

  • Connexion à une session
  • Publication de flux dans une session
  • S'abonner à des flux dans une session

Tous les SDK clients de Vonage Video pourront interagir les uns avec les autres. Vous pouvez en apprendre davantage sur les principes de base des clients, serveurs, sessions et autres de Vonage Video sur notre site Web. Aperçu de l'API Video page.

La référence du SDK Web de l'API Video de Vonage se trouve à l'adresse suivante ici.

Chargement de OpenTok.js

Pour charger OpenTok.js dans votre page web, ajoutez la balise script suivante :

<script src="https://video.standard.vonage.com/v2/js/opentok.min.js"></script>

Vous pouvez également installer OpenTok.js à l'aide de la commande @vonage/client SDK-vidéo paquet npm.

Visitez le site Guide de référence pour voir toutes les méthodes disponibles pour le SDK OpenTok.js.

La version actuelle de la bibliothèque OpenTok.js peut interopérer avec les applications Vonage Video écrites avec la version 2.31+ des SDK clients Vonage Video :

  • OpenTok.js (Web)
  • SDK Android
  • SDK iOS
  • SDK Windows
  • SDK macOS
  • SDK Linux
  • SDK React Native

Prise en charge des navigateurs

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

  • Google Chrome (dernière version)
  • Google Chrome pour Android (dernière version)
  • 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 de la version de bureau uniquement)
  • Electron (dernière version)
  • Samsung Internet (dernière version)
  • WebView Android API niveau 36+
  • WebView sur iOS 18.6+

Prise en charge de Safari

Apple a ajouté la prise en charge de WebRTC dans Safari 11 pour macOS et Safari sur iOS 11, et vous pouvez désormais utiliser les apps OpenTok.js sur Safari.

En outre, Safari 12.1 prend en charge le codec vidéo VP8, en plus du codec H.264. La prise en charge du VP8 dans Safari 12.1 est livrée avec macOS 10.14.4, et elle est également disponible pour macOS 10.13.6 et 10.12.6. Elle est également disponible dans la dernière version d'iOS 12.2.

Vous devez utiliser la version 2.16.0 ou ultérieure d'OpenTok.js pour utiliser le codec vidéo VP8 dans Safari.

Pour plus d'informations sur la prise en charge des codecs vidéo, voir le document suivant guide du développeur.

Limites

Les limitations suivantes concernent OpenTok.js sur Safari :

  • La publication de vidéos en partage d'écran n'est pas prise en charge dans Safari sur iOS et dans Safari 12 et les versions antérieures sur macOS. Elle est prise en charge dans Safari 13+ sur macOS.
  • Safari ne prend pas en charge l'accès aux caméras (ou la publication de flux) dans les pages chargées à l'aide des schémas URI http : (non sécurisé) ou file : (système de fichiers). Vous devez servir la page via https : (sécurisé). Toutefois, vous pouvez activer un drapeau pour prendre en charge HTTP (à des fins de test).
  • Safari ne prend pas en charge l'accès à la caméra sur localhost. Vous devez utiliser 0.0.0.0:xx (où xx est le numéro de port, par exemple 80).
  • Le chiffrement de bout en bout ne peut pas fonctionner sur Safari lorsque les outils de développement sont ouverts.

Anciennes versions

Les anciennes versions de Safari utilisent exclusivement le codec vidéo H.264 et ne prennent donc pas en charge le codec vidéo VP8.

En sessions acheminées (sessions utilisant le routeur multimédia), vous devez utiliser un projet dont le codec préféré est H.264 pour que les anciennes versions de Safari puissent publier des vidéos et s'y abonner. Définissez le codec vidéo préféré pour un projet sur la page Projet de votre compte Video API.

Dans un session acheminée (une session qui utilise OpenTok Media Router) dans un projet dont le codec vidéo préféré est VP8 (et non H.264), les clients utilisant des versions plus anciennes de Safari peuvent utiliser la plateforme vidéo de Vonage, mais sans support vidéo.

Exigences du système

Pour une diffusion vidéo fiable dans les navigateurs modernes, assurez-vous que votre appareil répond aux spécifications recommandées :

  • PROCESSEUR : Un processeur récent à deux cœurs ; un processeur à quatre cœurs (par exemple, Intel Core i5 / Ryzen 5) ou mieux pour le 1080p ou le multitâche lourd.
  • GPU : Graphiques intégrés modernes (Intel UHD/Iris Xe ou AMD Radeon ou Nvidia Graphics) pour 1080p ; la prise en charge du décodage matériel pour le codage vidéo est fortement recommandée.
  • MÉMOIRE VIVE : Au moins 8 Go pour le streaming quotidien ; 16 Go recommandés si vous gardez de nombreux onglets ou applications ouverts.
  • Stockage : SSD de préférence pour un chargement rapide et une bonne réactivité du système.
  • Réseau : Connectivité internet fiable ; fonctionne sur Wi-Fi, Ethernet ou cellulaire.
  • Autre : L'accélération matérielle doit être activée dans le navigateur pour des performances optimales.

Ces recommandations garantissent une lecture stable, une utilisation réduite de l'unité centrale et des performances fluides lors de la diffusion de vidéos.

Numbers de version

Vous pouvez inclure la bibliothèque OpenTok.js dans votre page web à l'aide d'une balise <script> étiquette :

<script src="https://video.standard.vonage.com/v2/js/opentok.min.js"></script>

Le numéro de version d'OpenTok.js se compose de trois parties :

  • Le numéro de version majeure - Ce numéro (le premier) est incrémenté lorsqu'une nouvelle version inclut une modification de l'API qui n'est pas rétrocompatible.
  • Le numéro de version mineure - Ce numéro (le deuxième) est incrémenté lorsqu'une nouvelle version ajoute de nouvelles fonctionnalités.
  • Le numéro de patch - Ce numéro (le troisième) est incrémenté lorsqu'il existe une nouvelle version qui corrige des bogues ou améliore les performances sans ajouter de nouvelles fonctionnalités.

Par exemple, v2.4.0 est la version majeure 2, la version mineure 4 (de la version majeure 2) et la révision 0 (de v2.4). Au fur et à mesure que les versions de révision sont publiées, les modifications sont incluses dans la révision mineure racine. Par exemple, lorsque la version 2.2.3 est publiée, ses modifications sont incluses dans la version 2.2.

Pour faire référence à une révision spécifique, vous pouvez inclure le numéro de version complet (tel que "v2.4.0") dans le champ src . Cependant, nous vous recommandons de ne spécifier que le numéro de version majeure. Vonage soutient officiellement la version actuelle de la bibliothèque. Si vous chargez une version plus ancienne, nous vous demandons de la mettre à jour afin de bénéficier des dernières corrections de bogues et fonctionnalités de la plateforme vidéo de Vonage.

Important : Utilisez toujours les bibliothèques que nous fournissons sans les modifier. Vous êtes ainsi assuré d'utiliser le code le plus récent et le plus testé. L'API Video de Vonage ne prend pas en charge l'utilisation de bibliothèques modifiées.

Pour savoir quand de nouvelles versions d'OpenTok.js sont disponibles, abonnez-vous à l'API Video de Vonage. Annonces forum.