Guia do usuário da ferramenta WebRTC Validator

Visão geral

A ferramenta de validação do WebRTC é uma ferramenta baseada na Web que tem como objetivo emular o player do WebRTC disponível nos Google Smart Displays com Google Assistant. Esse aplicativo da Web aproveita a API WebRTC disponível em navegadores modernos. De modo geral, a ferramenta de validação do WebRTC é um peer do WebRTC que pode ser transmitido ou recebido.

Acessar a ferramenta de validador WebRTC

Imagem de visão geral da ferramenta de validação do WebRTC.

Personalizar o servidor STUN/TURN

Por padrão, a ferramenta de validação do WebRTC usa o servidor STUN do Google. A ferramenta de validação do WebRTC pode usar um servidor STUN/TURN definido pelo usuário.

Caixa de seleção do servidor STUN/TURN.

Como adicionar um servidor STUN/TURN

  1. Coloque o endereço do servidor STUN ou TURN na caixa de texto STUN ou TURN URI. Verifique se o esquema de URI está no formato scheme:host:[port]. Por padrão, a ferramenta usa stun:stun.l.google.com:19302
  2. (Opcional) Se você estiver usando um servidor TURN, será necessário digitar as credenciais na caixa de texto Nome de usuário do TURN e Converter senha.
  3. Clique em Adicionar servidor para adicionar os detalhes do servidor à ferramenta.

Os servidores STUN/TURN serão usados na ordem em que aparecem na lista.

Como remover um servidor STUN/TURN

  1. Selecione o servidor STUN/TURN que você quer remover.
  2. Clique em Remover servidor.

A ferramenta vai usar stun:stun.l.google.com:19302 se nenhum outro servidor STUN/TURN for especificado.

Ativar/desativar o envio de áudio

  1. Por padrão, a ferramenta envia áudio como parte do fluxo do WebRTC. Se quiser desativar o envio de áudio, desmarque a caixa de seleção Ativar áudio.
Caixa de seleção de áudio

Botão "Enviar"

Depois de confirmar os servidores STUN/TURN e as preferências de áudio, clique em Enviar.

Botão "Enviar"
Caixa de diálogo de permissão da câmera

A entrada de vídeo da sua webcam será exibida no elemento de vídeo local.

SDP de criação de oferta

  1. Clique em Criar SDP de oferta para gerar um SDP de oferta. O JSON de oferta será formatado no seguinte formato:
    {
    "action": "offer",
    "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
    }

2.O SDP de oferta agora pode ser transmitido para um peer do WebRTC. Pode ser o agente WebRTC do Google Smart Home ou a ferramenta de validação do WebRTC em execução em outro navegador.

SDP de envio de resposta

  1. Coloque o JSON da resposta na caixa de texto do SDP da resposta e clique em Enviar SDP da resposta. O JSON de resposta precisa estar neste formato:

    {
    "action": "answer",
    "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..."
    }
  2. Se o SDP de resposta for válido, o vídeo e o áudio da fonte remota ficarão visíveis no elemento de vídeo remoto.

Como depurar o WebRTC

É altamente recomendável usar a ferramenta de validação do WebRTC com um navegador Chrome (versão 87 ou mais recente). As ferramentas do navegador Chrome poderão ajudar a depurar seu fluxo de WebRTC.

Página do WebRTC Internals

  1. Abra uma nova guia no navegador Chrome.
  2. Acesse o seguinte endereço chrome://webrtc-internals
Janela de inspeção do WebRTC

Essa página mostra todas as conexões ativas do WebRTC. As estatísticas e métricas geradas nesta página são coletadas da API getStats().

Ferramentas para desenvolvedores do Chrome

As Ferramentas para desenvolvedores do Chrome também são úteis para resolver problemas com o stream da WebRTC. É altamente recomendável abrir o Console antes de usar a ferramenta WebRTC Validator.