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

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 modernes. Plus généralement, l'outil de validation WebRTC est un paire WebRTC à partir duquel ou vers lequel vous pouvez diffuser du contenu.

Accéder à l'outil de validation WebRTC

Image d'ensemble de l'outil de validation WebRTC.

Personnaliser le serveur STUN/TURN

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

Case de sélection du serveur STUN/TURN.

Ajouter un serveur STUN/TURN

  1. Saisissez l'adresse du serveur STUN ou TURN dans la zone de texte URI STUN ou TURN. 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 devez saisir les identifiants dans les zones de texte Nom d'utilisateur TURN et Mot de passe TURN.
  3. Cliquez sur Add Server (Ajouter un serveur) pour ajouter les informations sur le serveur à l'outil.

Les serveurs STUN/TURN seront 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 utilisera stun:stun.l.google.com:19302 si aucun autre serveur STUN/TURN n'est spécifié.

Activer/Désactiver l'envoi d'audio

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

Bouton "Envoyer"

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

Bouton "Envoyer"
Boîte de dialogue d'autorisation d'accès à l'appareil photo

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

Créer une SDP d'offre

  1. Cliquez sur Créer un SDP d'offre pour générer un SDP d'offre. Le fichier JSON de l'offre se présente comme suit:
    {
    "action": "offer",
    "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
    }

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

Envoyer la réponse SDP

  1. Placez le fichier JSON de la réponse dans la zone de texte SDP de la réponse, puis cliquez sur Envoyer le SDP de la réponse. La réponse JSON doit être au format suivant:

    {
    "action": "answer",
    "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
    }
  2. Si l'SDP de réponse est valide, la vidéo (et l'audio) de la source distante sera visible dans l'élément vidéo à distance.

Déboguer WebRTC

Nous vous recommandons vivement 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 Webrtc-Internals

  1. Ouvrez un nouvel onglet dans votre navigateur Chrome.
  2. Accédez à l'adresse suivante : chrome://webrtc-internals
Fenêtre d'inspection WebRTC

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 pour les développeurs Chrome vous aideront également à 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.