Pratiques exemplaires pour commencer avec la vidéo de Vonage
Ce guide décrit quelques bonnes pratiques pour démarrer avec l'API Video de Vonage, couvrant des sujets tels que la configuration de votre environnement, la garantie d'une bonne expérience utilisateur, ainsi que la sécurité et la confidentialité.
Qu'est-ce que l'API Video ?
Vonage Video utilise webRTC pour les communications audio-vidéo et se compose de bibliothèques client pour web, iOS, Android, React Native, Fenêtreset Linuxainsi que SDK serveur et API REST. Termes clés :
- La plateforme Video API utilise des jetons pour l'autorisation, ce qui signifie que vous n'avez pas à vous soucier de créer des utilisateurs sur la plateforme ; si nécessaire, ils peuvent être créés par l'application.
- Session: Une session est un groupe logique de connexions et de flux. Les connexions au sein d'une même session peuvent échanger des messages. Considérez une session comme une "salle virtuelle" où les participants peuvent interagir les uns avec les autres. Les sessions ne doivent pas être réutilisées, car cela complique le dépannage et rend votre mise en œuvre potentiellement moins sûre.
- ConnexionUne connexion est un point d'extrémité qui participe à une session et qui est capable d'envoyer et de recevoir des messages. Une connexion a une présence, elle est soit connectée et peut recevoir des messages, soit déconnectée.
- FluxL'échange d'octets se fait par le biais d'un flux de médias entre deux connexions. Cela signifie que des octets contenant des médias sont échangés. Le média peut consister en de l'audio uniquement, ou de l'audio et de la vidéo. Vous pouvez également créer des partages d'écran et des flux personnalisés.
- Éditeur: clients publiant des flux de médias.
- Abonné: clients recevant des flux de médias.
De plus amples informations sur l'API Video sont disponibles sur le site Web de la Commission européenne. Détails techniques et un guide détaillé sur la façon d'utiliser l'API Video est disponible à l'adresse suivante Pour commencer.
Meilleures pratiques pour les projets et les serveurs
Mise en place de l'environnement
Lorsque vous concevez une application vidéo, envisagez d'avoir deux environnements : l'un pour les tests et l'autre pour la production. Pour tester des éléments simples ou reproduire des problèmes, vous pouvez également utiliser notre terrain de jeu, dont le lien figure ci-dessous :
- Créez une application pour chaque environnement, comme le développement et la production.
- Terrain de jeux
Comprendre les versions de l'API (et du SDK)
Pour les clients de l'environnement Enterprise, il est important de noter que les applications nouvellement créées utiliseront par défaut l'environnement Standard. Si vous devez passer de l'environnement Standard à l'environnement Entreprise, vous pouvez le faire dans la section paramètres de l'application.
Pour vous assurer que votre application appelle le SDK Enterprise JS, utilisez la source = https://video.enterprise.vonage.com/v2/js/opentok.js afin de vous assurer une assistance à long terme pour vos SDK.
Pour plus d'informations, visitez le site Guide de l'environnement d'entreprise.
Meilleure pratique pour configurer les informations d'identification de votre compte
Gardez ces lignes directrices à l'esprit lorsque vous créez les informations d'identification de votre compte :
ID de l'application et clé privée
- Vonage Video n'utilise pas la clé et le secret de l'API du compte, mais repose sur l'utilisation d'une application Vonage.
- Gardez la clé privée secrète en ne l'exposant PAS aux dépôts publics.
- N'enregistrez PAS la clé privée dans les bibliothèques des clients/les SDK mobiles compilés.
- N'effectuez pas d'appels à l'API REST à partir des applications clientes ou des applications mobiles. Cela exposerait votre clé privée et rendrait votre Account vulnérable. Seul l'identifiant de l'application doit être considéré comme une information publique.
ID de la session
- Générer toujours un nouveau
sessionIdpour chaque nouvelle session créée. - Les scores et données de qualité des sessions sont indexés par
sessionId. S'il y a plusieurs conversations (réunions) parsessionIdil sera difficile de le déboguer à l'aide de l'interface de Vonage. outil d'inspectioncar réutilisésessionIdont tendance à rapporter des scores de qualité globale inférieurs à la qualité d'appel réelle ressentie par les utilisateurs finaux.
Jetons
- Le serveur qui génère les jetons doit être placé derrière un point de terminaison sécurisé/authentifié.
- Il faut toujours générer de nouveaux jetons pour chaque participant.
- Ne pas stocker ou réutiliser les jetons.
- Par défaut, les jetons expirent au bout de 24 heures, ce qui est vérifié au moment de la connexion. Ajustez l'expiration au besoin, en fonction de votre cas d'utilisation et de votre application.
- Ajoutez des informations supplémentaires aux jetons (à l'aide du paramètre data), telles que des noms d'utilisateur ou d'autres informations permettant d'identifier les participants, mais n'utilisez JAMAIS d'informations personnelles.
- Définissez des rôles le cas échéant, tels que modérateur, éditeur et abonné.
- Pour plus d'informations sur les jetons, consultez le site suivant Aperçu de la création de jetons.
Comprendre le routeur média et les modes média
Lorsque vous créez une session, vous spécifiez comment les clients de la session enverront les flux audio-vidéo, ce que l'on appelle le mode média. Il existe deux options : le mode relayé et le mode routé :
Mode relayé :
Ce mode média n'utilise pas les serveurs média de Vonage, mais tente plutôt de créer une connexion média directe entre les participants. Avant de décider d'utiliser ou non le mode relayé, veillez à prendre en compte les éléments suivants :
- Les fonctions de la plateforme telles que l'archivage (enregistrement), l'intégration SIP, la diffusion en direct et le compositeur d'expérience ne sont pas nécessaires.
- Le cas d'utilisation concerne uniquement les sessions individuelles et tripartites.
- Lorsque les médias directs entre les participants sont privilégiés
- Le cryptage des médias de bout en bout est nécessaire
Notez que la qualité du média ne sera pas gérée en mode relayé, étant donné que le média est échangé entre les clients. Par conséquent, le réglage de la fréquence d'images et/ou de la résolution de l'abonné ne fonctionnera pas. Pour plus d'informations sur les jetons, consultez la page Vidéo évolutive page.
Mode routé :
Ce mode média utilise les serveurs média de Vonage. Avant de décider d'utiliser ou non le mode routé, vérifiez les points suivants :
- que vos sessions vidéo compteront trois participants ou plus
- Besoin éventuel d'archivage
- Nécessite un contrôle de la qualité des médias (repli audio et récupération vidéo)
- Il peut être nécessaire d'utiliser l'interconnexion SIP
- Il peut être nécessaire d'utiliser la diffusion interactive ou en direct.
- Le cryptage de bout en bout nécessite un abonnement supplémentaire et n'est pas pris en charge par tous les SDK.
Pour plus d'informations sur les modes de communication, consultez le site web de la Commission européenne. Aperçu de la création d'une session.
Pour plus d'informations sur le chiffrement de bout en bout en mode routé, consultez la page Chiffrement de bout en bout page.
Routage adaptatif des médias
À partir d'OpenTok.js v2.24.7, les sessions routées sont optimisées pour utiliser le routage adaptatif des médias, si possible. Le routage adaptatif des médias détermine si les médias peuvent être relayés sans le routeur de médias pour la diffusion vidéo en tête-à-tête, afin d'optimiser les performances des médias entre deux participants. La session acheminée adapte automatiquement le routage des médias pour utiliser le routeur de médias lorsque cela est nécessaire - pour les sessions avec trois participants ou plus, l'archivage, les diffusions en direct, l'interconnexion SIP, Experience Composer et Audio Connector.
Repli audio
En mode routé, le SDK Vonage revient automatiquement au mode audio uniquement si la bande passante est trop faible pour prendre en charge les appels vidéo. Toutefois, si vous souhaitez remplacer ce comportement, il est possible de le faire en définissant audioFallback sur false sur le OT.initPublisher.
Méthode Getstats
En plus de l'implémentation de la solution de repli audio personnalisée mentionnée ci-dessus, getStats() Les sondages peuvent être utilisés pour capturer des informations sur la qualité de la connexion afin d'afficher des informations en temps réel à l'intention de l'utilisateur et à des fins de dépannage.
Outil d'inspection de Vonage
Les Outil d'inspection de Vonage peut être utilisé pour comprendre la performance des médias pendant la session, ainsi que les codecs, les modes (relayés ou acheminés), les événements et les fonctions avancées qui ont été utilisés pendant l'appel.
Méthode d'émission des rapports
Il est possible de signaler des erreurs dans l'inspecteur en vue d'un examen ultérieur. L'inspecteur ID de la question du rapport peut également être utilisé pour rechercher un inspecteur sans connaître le sessionId.
Radiodiffusion
L'API Video offre aux utilisateurs deux options pour publier des vidéos en direct à un public plus large : une diffusion interactive et une diffusion en direct.
Diffusion interactive
Ce type de diffusion permet aux clients d'interagir les uns avec les autres en s'abonnant au flux de chacun. Il est important de noter que ce type de diffusion peut prendre en charge jusqu'à 15 000 abonnés en Full HD. Vous trouverez ci-dessous les éléments à prendre en compte lors de l'utilisation de ce type de diffusion :
Visiter Simulcast vidéo évolutif de Vonage pour en savoir plus sur Simulcast. Par défaut, la diffusion simultanée est activée après que la troisième connexion a rejoint l'appel (ceci afin d'éviter la diffusion simultanée dans les appels individuels).
Pour remplacer la valeur par défaut et désactiver la vidéo évolutive pour les éditeurs dans une session acheminée, vous pouvez utiliser l'option
scalableVideodans l'optionOT.initPublisher()méthode. Gardez à l'esprit que le nombre maximum d'abonnés sera affecté par l'augmentation du nombre d'éditeurs. Pour obtenir le nombre maximum d'abonnés, consultez le tableau sur la page "Guide "Diffusions vidéo interactives en direct.Pour assurer la stabilité des sessions volumineuses, supprimez les événements de connexion. "Guide "Suppression des événements de connexion.
Des sessions WebRTC plus importantes sont possibles lorsque l'on utilise l'option Compositeur d'expérience.
Streaming en direct
Ce type de diffusion permet à plus de 15 000 abonnés de souscrire à des flux. Il existe deux types de protocoles pour diffuser des vidéos : RTMP (Real Time Messaging Protocol) et HLS (HTTP Live Streaming). Quel que soit celui que vous choisissez, limitez le nombre d'éditeurs pour une meilleure expérience des téléspectateurs.
HLS vs RTMP
- HLS prend en charge un nombre illimité d'abonnés, alors que RTMP est limité par la plateforme de diffusion.
- HLS est retardé de 15 à 20 secondes, tandis que RTMP (à partir de la plateforme de Vonage) est retardé de cinq secondes ; cela n'inclut pas le retard de la plateforme de diffusion RTMP, car elle induit également des retards en fonction de la manière dont elle traite la vidéo.
- Le HLS à faible latence (LL-HLS) est retardé de 4 à 6 secondes.
- La lecture HLS n'est pas prise en charge par tous les navigateurs, mais il existe des plugins que vous pouvez utiliser, tels que flowplayer. La lecture permet aux utilisateurs de revenir en arrière, en effectuant un balayage vidéo (retour en arrière/avance rapide), depuis le début du flux en direct, puis de revenir au flux en direct actuel.
- Le mode DVR peut être activé lorsque vous créez une session HLS. Il s'agit d'une norme Apple qui permet aux utilisateurs de lire, mettre en pause et reprendre une session HLS en direct dans une fenêtre de 2 heures.
- La durée maximale par défaut de HLS/RTMP est de quatre heures. Si la diffusion doit durer plus longtemps, modifiez la propriété de durée maximale (la durée maximale est de 10 heures).
- Les flux HLS/RTMP s'arrêtent automatiquement soixante secondes après que le dernier client se soit déconnecté de la session.
Pour en savoir plus sur la diffusion en direct, comme les mises en page, la durée maximale et la façon de démarrer/arrêter la diffusion en direct, consultez le site Web de la Commission européenne. Guide des diffusions en direct.
Meilleures pratiques en matière d'interface et d'expérience utilisateur
D'une manière générale, il est recommandé de lire et de suivre les instructions suivantes Documentation sur la personnalisation de l'interface utilisateur et suivez les sections pertinentes pour votre application.
Garantir une bonne expérience utilisateur
Test de précallation
Ajoutez un test d'appel préalable où l'appareil et la connexion de l'utilisateur seront soumis à un test de réseau et de matériel avant de rejoindre une session. N'oubliez pas de générer de nouveaux identifiants de session pour chaque test et de laisser le test se dérouler pendant au moins 30 secondes pour obtenir des résultats plus précis.
Les généralités Outil de test Vonage Precall peut être utilisé par vous et vos clients pour des tests génériques de connectivité à l'API Video.
Si vous souhaitez intégrer votre propre test PreCall et rassembler toutes les données du test, plusieurs ressources sont à votre disposition :
- Échantillons Github iOS et Android
- Kit de test du réseau Javascript
- Vous pouvez également vérifier comment un test Precall peut être intégré dans une application complète en consultant notre Outil de précision
Gestionnaires de flux vidéo
Les gestionnaires d'achèvement peuvent vous donner un retour d'information lorsque vous essayez de vous connecter, de publier, de vous abonner ou d'envoyer des signaux à une session d'API vidéo. Ils sont décrits ici :
- Gestion des exceptions en Javascript
- Gestion des exceptions dans iOS
- Gestion des exceptions sous Android
Vous pouvez également écouter les événements d'exception sur l'objet OT, qui lancera des événements d'exception pour des erreurs plus générales décrites dans la section Événements exceptionnels
Une fois la connexion établie, vous publiez généralement des fichiers audio et vidéo et vous vous abonnez aux flux des autres participants. Lorsque vous gérez les éditeurs et les abonnés dans le cadre de l'interface utilisateur, vous pouvez utiliser les événements respectifs des instances d'éditeur et d'abonné, ce qui vous permet d'afficher des informations utiles aux utilisateurs lorsque des événements ou des exceptions spécifiques se produisent. Les événements de l'éditeur et de l'abonné peuvent être différents et sont décrits ici :
Repli audio
Notre serveur multimédia vérifie en permanence les conditions du réseau et s'il détecte un problème avec la connexion des utilisateurs finaux, il abandonne automatiquement la vidéo et continue avec l'audio uniquement, si la perte de paquets est supérieure à 15 % ; et un événement est envoyé lorsque cela se produit. Il est recommandé d'afficher cet événement sur l'interface utilisateur pour avertir les utilisateurs concernés que la qualité de leur connexion a baissé et qu'ils passent à l'audio uniquement. Le seuil de passage à l'audio seul n'est pas configurable, plus d'informations peuvent être trouvées dans ces exemples :
Le retour audio est activé par défaut, mais il peut être désactivé à l'aide de l'option audioFallbackEnabled paramètre. Voir ici
Reconnexion à la session
Lorsqu'un participant quitte soudainement une session en raison de problèmes liés au réseau, il tente de se reconnecter à la session. Pour une meilleure expérience utilisateur, il est recommandé de capturer ces événements et de les afficher correctement dans l'interface utilisateur, afin d'indiquer à l'utilisateur qu'il tente de se reconnecter à la session. Pour plus d'informations, voir ici.
Haut-parleur actif
Pour les sessions audio uniquement, essayez d'ajouter un indicateur de niveau audio afin que les participants puissent voir quel est ou quels sont les orateurs actifs. Pour la vidéo, essayez de modifier la mise en page de manière à ce que l'orateur actif dispose de plus d'espace à l'écran. Vous pouvez utiliser la fonction audioLevelUpdated qui est envoyé périodiquement pour faire de la Ajustements de l'interface utilisateur.
Détecteur de sonorité
Une bonne pratique consiste à mettre en œuvre un détecteur d'intensité sonore pour identifier le moment où un utilisateur donné, dont le son est coupé, essaie de parler. Dans ce cas, le audioLevelUpdated se déclenchera avec un niveau audio fixé à 0. Il est donc nécessaire d'utiliser un AudioContext pour éviter cette situation.
Contrôle de la résolution/fréquence d'images
L'objet Subscriber fournit des méthodes permettant de réduire la résolution et/ou la fréquence d'images reçues. Ceci est utile dans le cadre d'une économie de bande passante et de ressources CPU si vous affichez un grand nombre de participants (par exemple plus de 4 sur un mobile ou plus de 8 sur un ordinateur de bureau)
Éviter les problèmes audio
Lors d'appels importants, les participants peuvent, par inadvertance, introduire du bruit ou de l'écho dans l'appel. Plus le nombre de participants est élevé, plus ce phénomène risque de poser problème. C'est pourquoi vous pouvez envisager un système de mise en sourdine automatique lors de la connexion et/ou un bouton de mise en sourdine de tous les modérateurs pour les sessions plus importantes.
Report Issue API
Signaler un problème permet au consommateur final de l'application de déclencher un numéro d'identification unique à partir du client. Notre client peut stocker cet identifiant de problème et l'utiliser lorsqu'il soulève un ticket auprès du service d'assistance. L'identifiant de problème permettra d'identifier l'identifiant de connexion unique qui a signalé le problème et d'orienter l'enquête du service d'assistance.
Indice de localisation
Quand création d'une sessionvous pouvez définir une région préférée où l'appel vidéo sera hébergé. Cela peut s'avérer utile pour les sessions de grande envergure, lorsque vous savez que la plupart des utilisateurs se joindront à l'appel à partir d'une région spécifique. Notez que cela ne garantit pas l'utilisation d'un centre de données spécifique. Zones médiatiques régionales.
Améliorer l'expérience de l'astreinte
- Flou d'arrière-plan/remplacement - Le SDK JS propose une méthode simple pour rendre l'arrière-plan flou ou le remplacer par une image. Dans ce dernier cas, veillez à ce que l'image d'arrière-plan ait le même rapport hauteur/largeur que le flux publié et soyez conscient que l'arrière-plan peut être recadré en fonction de la taille de l'image d'arrière-plan.
fitModedescription de la configuration ici. Notez que le flou et le remplacement de l'arrière-plan ne sont pris en charge que dans les versions récentes de Chrome, Electron, Opera et Edge. Ils ne sont pas pris en charge dans les autres navigateurs (non basés sur Chrome) ni sur iOS.
Il faudrait vérifier si c'est toujours le cas
Processeur de médias - Utilisez la bibliothèque Vonage Media Processor pour appliquer des transformations personnalisées aux vidéos publiées sur les ordinateurs de bureau et les téléphones portables, y compris de manière native à l'aide de nos SDK mobiles. Cela prend en charge le flou et le remplacement de l'arrière-plan, mais aussi des cas d'utilisation plus avancés tels que la réalité augmentée et l'audio spatial.
API pour les sous-titres en direct - Utilisez cette API simple pour transcrire des flux audio et générer des sous-titres en temps réel pour votre application. L'API Live Captions vous permet d'afficher des sous-titres en direct aux utilisateurs finaux dans une session Vonage Video, à l'aide d'un service de transcription.
Connecteur audio - Grâce à Audio Connector, vous pouvez envoyer des flux audio bruts (PCM 16 khz/16bit) d'une session vidéo Vonage en direct vers des services externes tels que AWS, GCP, Azure, etc, individuellement ou mélangés. Vous pouvez également identifier le locuteur en envoyant les flux audio individuellement en ouvrant plusieurs connexions WS. Les clients utilisent cette fonctionnalité pour créer des cas d'utilisation tels que les transcriptions médicales et la traduction en temps réel.
Caractéristiques de l'engagement
Chat (messagerie texte) - vous pouvez envoyer des messages en utilisant Signalisation de VonageLes messages ne sont pas stockés sur la plateforme vidéo de Vonage. Lorsque vous ajoutez la fonctionnalité de messagerie texte, gardez à l'esprit que certains utilisateurs peuvent arriver/se joindre à une session après l'envoi des messages texte ; les retardataires ne pourront pas voir les messages qui ont été envoyés. De plus, si vous décidez d'enregistrer une session, les messages texte ne seront pas capturés, à moins que vous ne mettiez en œuvre Experience Composer.
Partage d'écran
- Pensez à cacher l'éditeur qui partage leur écran pour éviter l'effet miroir de couloir.
- ContentHint : permet d'optimiser le partage d'écran en fonction des détails (comme un diaporama) ou du mouvement (comme une vidéo).mouvement, détails, etc. Cet indicateur peut et doit être activé après la version 2.20.
Compositeur d'expérience
Nous fournissons également des outils qui vous permettent de créer une mise en page composée hautement personnalisée. Cela vous permet de créer des applications Web pour construire des expériences UI/UX riches pour les utilisateurs finaux.
- Créer une page web qui sera affichée sur la plateforme Vonage
- Mélanger du contenu vidéo avec tout autre contenu web, tel que
- Fenêtre de chat
- Tableau blanc
- Contenu et mise en page avancés
- Le contenu peut être dynamique et changer tout au long de la session
- Le contenu composé peut être publié dans d'autres sessions vidéo, afin d'enregistrer, d'archiver et de diffuser, tout en conservant intactes les riches expériences UI/UX offertes aux utilisateurs.
Pour plus d'informations, voir le site Compositeur d'expérience documentation.
Meilleures pratiques d'archivage
Il existe deux types d'offres en matière d'enregistrement, les flux composés et les flux individuels.
Composé
- Peut enregistrer jusqu'à 16 flux vidéo, plus 34 flux supplémentaires où seul le son est enregistré, soit un total de 50 flux.
- Fichier MP4 unique contenant tous les flux multimédias
- Mise en page personnalisable
- Enregistrement d'écran et mises en page avancées comme les superpositions, les montages et les filigranes personnalisés (voir Compositeur d'expérience)
- Peut être démarré automatiquement (240 minutes maximum). Si l'enregistrement n'est pas arrêté, il commencera à être archivé dans un nouveau fichier)
- Il est possible de établir des priorités certains flux à inclure dans l'enregistrement en leur attribuant différentes classes de mise en page.
- Prend en charge les formats SD, HD et FHD.
Flux individuel :
- Peut enregistrer jusqu'à 50 flux, à la fois audio et vidéo
- Plusieurs flux/fichiers individuels enregistrés dans un dossier zip
- Destiné à être utilisé avec un outil de post-traitement pour produire un contenu personnalisé
- Impossible de démarrer automatiquement
Stockage des archives
Vonage conservera les archives pendant 72 heures si le téléchargement échoue, si le stockage en nuage n'a pas été configuré ou si l'option de désactivation du repli du stockage n'a pas été sélectionnée. Gardez à l'esprit que si vous décidez de ne pas activer le téléchargement de secours et que le téléchargement échoue pour quelque raison que ce soit, les archives ne pourront pas être récupérées.
- AWS S3 : Visiter Archivage avec AWS S3 pour savoir comment télécharger des fichiers d'archive sur AWS.
- Azure : Visite Archivage à l'aide d'un conteneur Windows Azure pour savoir comment télécharger des fichiers d'archive vers Azure.
- Google : Vous devez utiliser le mode conforme S3 et suivre les instructions S3 ci-dessus.
FAQ sur l'archivage
- Les archives sont-elles cryptées ?
Pas par défaut. Mais il est possible d'ajouter une fonction de cryptage pour les archives composées. Pour en savoir plus, visitez le site Cryptage des archives
- Pouvez-vous enregistrer uniquement le son ou uniquement la vidéo ?
Oui. L'utilisation de l'outil API REST, fixer le hasVideo/hasAudio à vrai ou faux.
- Puis-je nommer les archives afin de pouvoir les identifier par leur nom ?
Oui. L'utilisation de l'outil API REST, fixer le name à l'identifiant souhaité.
- Comment puis-je vérifier l'état des archives ?
Utiliser le inspecteur des archives.
- Puis-je enregistrer certains flux d'une session ?
Oui, voir Sélection des flux à inclure dans une archive.
- Puis-je enregistrer simultanément dans différents formats ?
Oui, vous pouvez lancer l'archivage plus d'une fois pour une session donnée. Cela signifie, par exemple, que vous pouvez enregistrer une présentation composée en même temps qu'un enregistrement séparé par participant (c'est-à-dire un archivage individuel).
Qualité, performance et compatibilité
Dispositifs - pour les sessions à plusieurs, essayez de limiter le nombre de participants, car un plus grand nombre de participants nécessite une plus grande puissance de traitement. Nous recommandons le nombre de participants suivant :
- Mobile = 4 (la déclaration officielle de l'ingénierie prévoit un maximum de 8)
- Ordinateur portable = 10
- Bureau = 25
Contrôle de la résolution/fréquence d'images - L'objet Abonné fournit des méthodes permettant de réduire la résolution et/ou la fréquence d'images reçues. Ceci est utile dans le contexte d'économie de bande passante et de ressources CPU si vous affichez un grand nombre de participants (par exemple, plus de 4 sur un mobile ou plus de 8 sur un ordinateur de bureau)
Exigences en matière de largeur de bande voir "Quelle est la largeur de bande minimale requise pour utiliser l'API Video de Vonage ?"
Proxy - si les utilisateurs ne peuvent accéder à l'internet qu'à travers un proxy, assurez-vous qu'il s'agit d'un proxy "transparent", sinon il doit être configuré dans le navigateur pour une connexion HTTPS, étant donné que webRTC ne fonctionne pas bien sur les proxys nécessitant une authentification. Consultez notre flux de vérification du réseau dans Lignes directrices pour les réseaux restreints
Pare-feu - l'article "Quelles sont les exigences en matière de connectivité réseau de l'API Video de Vonage ?" contient plus d'informations sur les ports optimaux pour un temps d'établissement de l'appel le plus rapide possible et une vidéo de meilleure qualité.
Codecs - Vonage prend en charge les codecs VP9, VP8 et H.264 ; voir la section Codecs pour plus d'informations sur les différences entre chaque codec.
Suivi de la session
Suivi de la session vous permet d'enregistrer une URL de webhook. Cette fonction permet de surveiller les sessions et les flux - par exemple, en limitant le nombre de participants à une session, ce qui est souvent utilisé parallèlement à la fonction de surveillance. forceDisconnect fonction. Le modérateur peut également appeler une action au serveur et lui demander de faire un Appel REST pour forcer la déconnexion.
Il peut également être utilisé pour suivre l'utilisation, mais pour un meilleur suivi de l'utilisation, il convient d'utiliser la fonction de suivi de l'utilisation. API Insights.
Si, dans un délai de 30 minutes, plus de 50 échecs de livraison d'événements sont constatés (c'est-à-dire que nous ne recevons pas de réponse 200 lorsqu'une requête HTTP est envoyée à votre URL de rappel), nous désactiverons le transfert d'événements dans le cadre du suivi de session. Nous vous enverrons un courrier électronique si cela se produit. Vous pouvez réactiver le contrôle de session sur la page de votre Account.
ConnectionCreated: vous pouvez utiliser Données de connexion pour identifier les connexions des utilisateurs. Par exemple, vous pouvez transmettre l'ID de l'utilisateur, le nom ou d'autres données décrivant le client (n'utilisez pas d'informations personnelles dans les données du jeton).
Compléments
La plupart des clients peuvent acheter (ou supprimer) des modules complémentaires d'un simple clic, configurés via l'outil en libre-service.
- Interconnexion SIP
- Configurable TURN
- Proxy IP
- Zones médiatiques régionales
- Liste des IP autorisées
- Archivage crypté
- Chiffrement des médias AES-256
- Chiffrement de bout en bout
- Connecteur audio
Sécurité et vie privée
L'API Video de Vonage peut être personnalisée pour répondre aux normes de sécurité les plus strictes. Notre plateforme est conforme au GDPR et nous sommes conformes à l'HIPAA. Pour les clients européens, nous proposons des modules complémentaires qui permettent de se conformer à des certifications et normes locales supplémentaires, telles que la certification KBV (Allemagne) ou d'autres lois sur la protection de la vie privée qui visent à améliorer la propriété et la protection des données (dans toute l'Europe).
Pour en savoir plus :
- GDPR
- Politique de confidentialité de Vonage
- Tous nos sous-processeurs
- Les Addendum sur le traitement des données (DPA)
Sur demande et sous NDA, nous pouvons fournir d'autres rapports tels que l'évaluation de l'impact du transfert de données, le rapport d'audit SOC2 Type 2 et les Pen Tests externes qui prouvent les normes de haute sécurité de notre plateforme vidéo.
Tarification
- Prix de l'API Video
- Comment estimer les frais mensuels de l'API Video dans le modèle de tarification pour les participants (PPM) ? - Minutes par participant (PPM) - modèle de tarification par défaut
- Comment estimer mes frais mensuels de Video API dans le modèle de tarification Subscribed Stream Minutes (SSM) ? - Session Subscriber Minutes (SSM) - Modèle de tarification traditionnel
Où puis-je obtenir de l'aide ?
Si vous avez des questions, vous pouvez vous joindre à notre Communauté de développeurs sur SlackVous pouvez également contacter notre Équipe d'assistance API.