Ferramenta CaC

A ferramenta de comando e controle (CaC, na sigla em inglês) é um remetente funcional da Web para que os desenvolvedores testem e depurem um aplicativo receptor da Web.

Os desenvolvedores podem usar a ferramenta CaC para:

  • Inicie um app receptor da Web em um dispositivo compatível com Cast e envie uma solicitação de carregamento para iniciar a reprodução de mídia.
  • Simule comandos de voz enviados pelo Google Assistente ao receptor da Web.
  • Capture registros do Cast Debug logger e controle a sobreposição de depuração do receptor da Web.

Iniciar o app Web Receiver

Há duas maneiras de iniciar o receptor da Web com a ferramenta CaC:

  1. Para iniciar uma nova sessão de transmissão, siga estas etapas:

    1. Abra a ferramenta CaC, insira o ID do app Web Receiver e clique no botão DEFINIR ID DO APP.

    2. Clique no botão Transmitir e selecione um dispositivo para iniciar o receptor da Web em um dispositivo remoto compatível com Cast.

  2. Para participar de uma sessão de transmissão:

    1. Receba o ID da sessão de transmissão em execução usando os seguintes códigos:

      No lado da Web Receiver, use o método a seguir para ver o ID da sessão no console do Chrome Remote Debugger:

      cast.framework.CastReceiverContext.getInstance().getApplicationData().sessionId;

      Para receber o ID da sessão de um remetente da Web conectado, use este método:

      cast.framework.CastContext.getInstance().getCurrentSession().getSessionId();

    2. Insira o ID da sessão na ferramenta CaC e clique no botão RETOMAR.

Quando a ferramenta CaC está conectada ao app Web Receiver, o botão "Transmitir" aparece com uma forma de frame preenchida. O ID do app Web Receiver e o ID da sessão também são exibidos na parte superior da ferramenta.

Carregar mídia

Carregar mídia do app remetente ou da ferramenta CaC.

App de remetente

Para iniciar a reprodução de mídia no Web Receiver, transmita o app remetente para o mesmo dispositivo compatível com Cast e envie uma solicitação de carregamento do app remetente ao Web Receiver.

Ferramenta CaC

A ferramenta CaC também fornece várias maneiras de enviar uma solicitação de carregamento para o app Web Receiver:

Carregar por entidade (transmissão de voz)

Quando o usuário inicia a reprodução de mídia pelo Google Assistente, ele usa mensagens de comando e controle (CaC, na sigla em inglês) para enviar as credenciais e a entidade do usuário ao receptor da Web.

A ferramenta CaC simula a transmissão de voz e envia uma solicitação de carregamento com credentials e entity.

Carregar por conteúdo

A ferramenta CaC também pode simular o app enviando uma solicitação de carregamento com Content ID ou Content Url.

Quando uma reprodução de mídia é iniciada, a ferramenta CaC recebe mensagens de status de mídia do seu app Web Receiver e as exibe na guia MEDIA STATUS.

Solicitação de carregamento personalizado

Se quiser testar o receiver usando seus próprios objetos Load Request, use o campo Custom Load Request na guia LOAD MEDIA. Primeiro, selecione o tipo de solicitação nos botões de opção Select Request Type e depois copie e cole ou crie seu próprio objeto JSON.

Testar comandos de voz

A ferramenta CaC também simula comandos de voz enviados pelo Google Assistente ao app Web Receiver. Você pode testar se os comandos de mídia compatíveis com seu app estão funcionando. Os comandos de mídia não compatíveis precisam ser processados com os tipos de erros e os motivos de erros adequados.

Inspecionar e controlar o Cast Debug Cast

Se o app Web Receiver ativar o Cast Debug logger, a ferramenta CaC capturará as mensagens de registro e controlará a sobreposição de depuração do Web Receiver.

Use os seguintes botões para controlar o Web Receiver e registrar mensagens:

  • ID do app Web Receiver
    • Limpar o cache e parar o receptor da Web: recarregue o app receptor da Web e interrompa a transmissão.
  • Sobreposição de depuração do receptor da Web
    • Mostrar: alterne a sobreposição de depuração no Web Receiver.
    • Limpar: limpar mensagens de registro na sobreposição de depuração do receptor da Web
  • Controles de mensagens de registro
    • Inserir mensagem: insira comentários ou divisores na área de registro.
    • Download Log: salvar mensagens de registro
    • Limpar registro: limpa as mensagens de registro na área de registro.
  • Mensagens de registro
    • Tags personalizadas: clique na caixa de seleção para filtrar mensagens de registro.

As tags a seguir podem aparecer em Tags personalizadas. Elas são adicionadas pela ferramenta CAC para mostrar e filtrar registros ou mensagens importantes relacionados à sessão de depuração:

  • MEDIA: mensagens enviadas com sucesso pelo namespace Media
  • MEDIA-ERROR: ocorreu um erro ao enviar ou em resposta a mensagens enviadas pelo namespace de mídia.
  • CAC: mensagens enviadas pelo namespace do CAC
  • CAC-ERROR: erro ocorrido ao enviar ou em resposta a mensagens enviadas pelo namespace do CAC
  • PLAYING: registro que exibe o resultado quando o botão O que está tocando é clicado na ferramenta CaC
  • USER: registro mostrando a mensagem personalizada inserida pelo usuário com o botão Insert Message na ferramenta CaC

Testar a conexão com o Google Cast

Para testar o Cast Connect, siga estas etapas antes de estabelecer uma sessão:

  1. Insira o ID do app receptor associado ao receptor ativado para Cast Connect e clique em Definir ID do app.
  2. Clique no botão Show Android TV Options.
  3. Marque a caixa de seleção androidReceivercompatible. Se o receptor não exigir que Launch Credentials seja definido ou se você quiser testar o que vai acontecer caso ele não esteja definido, pare aqui e continue para a Etapa 5.
  4. (Opcional) Insira o Launch Credentials e clique no botão Set Launch Credentials para definir as credenciais de lançamento da sessão Cast Connect.
  5. Inicie uma sessão de transmissão clicando no ícone de transmissão no cabeçalho ou no menu "Transmitir" no navegador Chrome.

O app Android TV será iniciado no dispositivo.

Anterior
Registrador de depuração do Cast
Próxima
Depurador remoto do Chrome