Guide de l'utilisateur de l'outil de validation WebRTC

Cloud-to-cloud

Présentation

L'outil de validation WebRTC est un outil Web qui vise à émuler le lecteur WebRTC disponible sur les écrans connectés Google avec Google Assistant. Cette application Web exploite l'API WebRTC disponible dans les navigateurs récents. Plus généralement, l'outil de validation WebRTC est un pair WebRTC à partir duquel vous pouvez diffuser des contenus.

Accéder à l'outil de validation WebRTC

Personnaliser le serveur STUN/Turn

Par défaut, l'outil de validation WebRTC utilise le serveur Google STUN. L'outil de validation WebRTC peut utiliser un serveur STUN/turn défini par l'utilisateur.

Ajouter un serveur STUN/Turn

1. Placez l'adresse du serveur STUN ou turn dans la zone de texte STUN ou turn URI. Assurez-vous que le schéma d'URI est au format scheme:host:[port]. Par défaut, l'outil utilise stun:stun.l.google.com:19302.
2. (Facultatif) Si vous utilisez un serveur turn, vous devrez saisir les identifiants dans la zone de texte Activer le nom d'utilisateur et transformer le mot de passe.
3. Cliquez sur Add Server (Ajouter un serveur) pour ajouter les informations sur le serveur à l'outil.

Les serveurs STUN/turn sont utilisés dans l'ordre dans lequel ils apparaissent dans la liste.

Supprimer un serveur STUN/Turn

1. Sélectionnez le serveur STUN/Turn que vous souhaitez supprimer.
2. Cliquez sur Supprimer le serveur.

L'outil utilise stun:stun.l.google.com:19302 si aucun autre serveur STUN/turn n'est spécifié.

Activer/Désactiver l'envoi de contenus audio

1. Par défaut, l'outil envoie du contenu audio dans le flux WebRTC. Si vous souhaitez désactiver l'envoi du contenu audio, décochez la case Activer l'audio.

Bouton "Envoyer"

Une fois que vous avez confirmé vos serveurs STUN/turn et vos préférences audio, cliquez sur Submit(Envoyer).

L'entrée vidéo de votre webcam s'affiche dans l'élément vidéo local.

Créer un SDP d'offre

1. Cliquez sur Créer un SDP pour les offres afin de générer un SDP pour les offres. Le format du fichier JSON de l'offre respecte le format suivant :

   {
   "action": "offer",
   "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
   }
   

2.Le SDP d'offre peut désormais être transmis à un pair WebRTC. Il peut s'agir de l'agent WebRTC de Google Smart Home ou de l'outil de validation WebRTC s'exécutant sur un autre navigateur.

Envoyer la réponse SDP

1. Placez la réponse JSON dans la zone de texte Answer SDP et cliquez sur Submit Answer SDP (Envoyer la réponse SDP). La réponse JSON doit être au format suivant:

   {
   "action": "answer",
   "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
   }
   

2. Si le SDP de la réponse est valide, la vidéo (et l'audio) de la source distante sera visible dans l'élément vidéo distant.

Déboguer WebRTC

Il est vivement recommandé d'utiliser l'outil de validation WebRTC avec un navigateur Chrome (version 87 ou ultérieure). Les outils du navigateur Chrome peuvent vous aider à déboguer votre flux WebRTC.

Page interne Webrtc

1. Ouvrez un nouvel onglet dans le navigateur Chrome.
2. Accédez à l'adresse chrome://webrtc-internals

Cette page affiche toutes les connexions WebRTC actives en cours. Les statistiques et les métriques générées sur cette page sont collectées à partir de l'API getStats().

Outils pour les développeurs Chrome

Les outils de développement Chrome seront également utiles pour résoudre les problèmes liés au flux WebRTC. Nous vous recommandons vivement d'ouvrir la console avant d'utiliser l'outil de validation WebRTC.