Registro

Registre seu aplicativo se você estiver usando o Receptor de mídia estilizado ou criando um Receptor personalizado. Depois de registrar seu aplicativo, você receberá um ID, que é usado pelo aplicativo remetente para realizar chamadas de API, como para iniciar um app Web Receiver.

Se você usa o Default Media Receiver, não precisa registrar seu aplicativo. O receptor de mídia padrão não permite fornecer estilos à IU do player de mídia e usa uma constante fornecida como o ID do aplicativo.

Além disso, é necessário registrar seu dispositivo com Google Cast para que ele possa acessar o aplicativo Web Receiver antes de publicá-lo. Assim que você publicar o app receptor, ele vai ficar disponível para todos os dispositivos com Google Cast.

Aplicativos

Registrar o aplicativo permite que você o teste no dispositivo de transmissão registrado antes de publicar o aplicativo. A publicação do aplicativo o disponibiliza para todos os dispositivos de transmissão.

Registrar o aplicativo

É preciso registrar um Receiver de mídia estilizado ou um Receptor personalizado para receber um ID do aplicativo usado com chamadas de API do aplicativo remetente.

Para registrar o app Google Cast:

  1. Faça login no Console do desenvolvedor do SDK do Google Cast.
  2. Na página Visão geral ou Aplicativos, clique em Adicionar novo aplicativo.
  3. Selecione o tipo de app Web Receiver usado:

    • Receptor personalizado

      Selecione essa opção caso o app precise de componentes da interface do usuário ou padrões de interação que não são fornecidos pelo receptor de mídia estilizado. Também pode ser necessário selecionar receptor personalizado se o tipo de conteúdo não estiver listado como um dos tipos de mídia compatíveis com o estilo de receptor de mídia.

      Essa opção requer a criação de um app da Web completo para o app Web Receiver.

      Para detalhes, leia Aplicativo receptor personalizado.

    • Receptor de mídia estilizado

      Selecione essa opção se o app transmitir conteúdo de vídeo ou áudio usando um dos tipos de mídia compatíveis e você quiser fornecer uma interface do usuário na TV que use a IU padrão do player de mídia ou um conjunto de estilos personalizados na IU do player de mídia padrão.

      Os estilos personalizados podem permitir que você defina a aparência de vários elementos da IU do jogador, como a tela de apresentação e a barra de progresso, com um arquivo CSS. Não é necessário criar um app de receptor.

      Para saber mais detalhes, leia Receptor de mídia estilizado.

  4. Preencha os detalhes do app Web Receiver:

    1. No campo Name, digite o nome do app.

      Este é o nome do aplicativo que aparece quando o receptor da Web está sendo carregado ou no estado inativo se você estiver usando o receptor de mídia estilizado. Se você estiver usando um receptor personalizado, o valor desse campo será o valor padrão do estado do aplicativo, se ele não for definido usando o método setApplicationState.

    2. Especifique a aparência do app Web Receiver:

      • No Receptor personalizado, no campo URL, especifique o URL do app.

        Insira um URL que o dispositivo com Google Cast deve solicitar ao carregar seu app Web Receiver. Durante o desenvolvimento, o URL pode usar HTTP, mas quando o app é publicado, ele precisa usar HTTPS. O URL pode ser uma página HTML ou outro tipo de arquivo acessível a partir de um navegador da Web. Não há problema em seu receptor da Web estar em um endereço IP interno (registrado pelo NAT), mas não em localhost, já que raramente é um domínio de nível superior. Embora o app Web Receiver precise ser exibido por SSL (HTTPS) quando publicado, o conteúdo carregado no app Web Receiver pode ser exibido por HTTP.

      • Para um Receptor de mídia estilizado, no campo URL do tema, especifique o URL da folha de estilo.

        Forneça um URL HTTPS que direcione para o arquivo CSS localizado no seu próprio site. Para usar os estilos padrão, deixe o campo em branco. É possível editar isso mais tarde se quiser fornecer ou atualizar seus estilos personalizados.

      • Marque ou desmarque a caixa de seleção Compatível com o modo visitante do Google Cast.

        O modo visitante permite que seu receptor da Web seja compatível com a transmissão de remetentes não conectados à mesma rede Wi-Fi que o receptor. Para desativar o modo visitante para seu receptor, desmarque essa caixa. Consulte ConvidadoMode para mais informações.

      • Marque ou desmarque a caixa de seleção Compatível com transmissão somente para dispositivos de áudio.

        Marque a caixa para permitir que seu app descubra o Google Cast para dispositivos de áudio. Para desativar o suporte a dispositivos somente de áudio, desmarque essa caixa. Consulte Dispositivos de áudio para saber mais.

  5. Clique em Salvar.

    Os detalhes do registro, incluindo o ID, nome, tipo e status do aplicativo, são exibidos. Anote o ID do aplicativo, porque ele fornece as chamadas da API Cast do aplicativo.

  6. Clique em Concluído para retornar à página "Aplicativos".

Editar informações do aplicativo

Antes de publicar o aplicativo, é preciso fornecer algumas informações adicionais. Também é possível atualizar as informações fornecidas sobre o aplicativo durante o registro.

Para editar informações do aplicativo:

  1. No Console do desenvolvedor do SDK do Google Cast, nas páginas Visão geral ou Aplicativos, clique no ID do aplicativo ou em Editar para o app que você quer editar.
  2. No campo Name, atualize o nome fornecido ao registrar o aplicativo.
  3. Para apps receptores personalizados, no campo URL, atualize o local do app receptor da Web registrado.
  4. Para aplicativos com receptor estilizado, no campo URL do tema, atualize o local da folha de estilo do seu aplicativo.
  5. Marque ou desmarque a caixa de seleção Compatível com o modo visitante do Google Cast.

    O modo visitante permite que seu receptor da Web seja compatível com a transmissão de remetentes não conectados à mesma rede Wi-Fi que o receptor. Para desativar o modo visitante para seu receptor, desmarque essa caixa. Consulte Modo visitante para mais informações.

  6. Marque ou deixe a caixa de seleção Compatível com transmissão apenas para dispositivos de áudio.

    Marque a caixa para permitir que seu app descubra o Google Cast para dispositivos de áudio. Para desativar o suporte para dispositivos somente de áudio, desmarque esta caixa. Consulte Dispositivos de áudio para saber mais.

  7. Na seção Detalhes do remetente, forneça o seguinte para cada plataforma compatível com seu app:

    • Android:

      • o nome totalmente qualificado do pacote do seu aplicativo.
    • iOS:

      • o ID do iTunes e o ID do pacote exigidos pela Apple.
      • O URI de inicialização do app, usando o URI que o app Google Home usa para iniciar seu app. Para mais informações sobre o formato de URI obrigatório, consulte Como usar esquemas de URL para se comunicar com apps.
    • Web:

      • o URL do site do seu aplicativo.
  8. Na seção Detalhes do anúncio, escolha se quer listar o aplicativo nos Serviços do Google, como chromecast.com/apps.

  9. No menu suspenso Categoria, selecione a categoria que melhor descreve seu aplicativo.

    Observação: seu app precisa ser compatível com os tipos de mídia descritos aqui e com os implícitos por outras configurações. Por exemplo, se o app for compatível com Google Cast para áudio e você selecionar "TV e filmes" aqui, ele precisará oferecer suporte a dispositivos somente de áudio, conforme descrito em Dispositivos de áudio, bem como às disposições para reprodução de vídeo.

  10. Para descrever os países em que o app está disponível, selecione o botão de opção Todos os países ou Apenas em países selecionados. Se especificar países, marque as caixas para esses países na lista exibida.

  11. No campo Título, forneça um título descritivo para o aplicativo.

    Use até 50 caracteres. Por exemplo, "YouTube".

  12. No campo Descrição, digite uma descrição para o aplicativo.

    Use até 80 caracteres. Por exemplo, "Aproveite seus canais favoritos do YouTube na melhor tela da casa".

  13. Na seção Gráficos, clique no sinal de adição para fazer upload da imagem de ícone do aplicativo.

    A imagem precisa ter 512 x 512 pixels e um plano de fundo transparente.

  14. Em Add Your Own Translations, se você quiser fornecer traduções para os campos Title e Description, selecione o idioma no menu suspenso, clique em Add e insira o texto traduzido na caixa de diálogo exibida. Você também pode fazer upload de uma imagem para o ícone específico dessa tradução.

  15. Quando terminar de atualizar as informações do seu aplicativo, clique em Salvar.

Publicar seu aplicativo

A publicação o disponibiliza para todos os dispositivos de transmissão em todo o mundo. Ela também cria uma ficha para seu aplicativo nas propriedades do Google, como o site de chromecast.com/apps, em que os usuários podem descobrir e fazer o download do seu app. Caso você tenha escolhido listar o app ao editar as informações da etapa 6, ele aparecerá em chromecast.com/apps depois de ser publicado.

Para publicar o aplicativo:

  1. No Console do desenvolvedor do SDK do Google Cast, nas páginas Visão geral ou Aplicativos do aplicativo que você quer publicar, clique em Publicar.

    Se as informações do aplicativo estiverem completas, uma tela de visualização aparecerá com as informações inseridas em Editar informações do aplicativo. Caso contrário, uma mensagem será exibida citando as informações que você precisa fornecer.

  2. Clique em Editar para voltar e atualizar as informações.

  3. Se estiver tudo pronto para publicar o aplicativo, clique em Publicar.

Estatísticas

O Console do desenvolvedor do SDK do Google Cast acompanha o desempenho do seu app. Para cada aplicativo publicado na página "Aplicativos" ou "Visão geral", veja os dados de desempenho clicando em Visualizar na coluna Estatísticas.

As seguintes informações são apresentadas:

  • Número de receptores do Google Cast que iniciaram o aplicativo
  • Número de sessões iniciadas
  • Tempo médio de reprodução de mídia (em minutos) por sessão

Se uma plataforma Outro aparecer nas estatísticas, o remetente não indicou a plataforma. Por exemplo, se um remetente iOS mais antigo não foi atualizado.

Dispositivos

Por padrão, os dispositivos com Google Cast (como um Chromecast ou um dispositivo Android TV) não são habilitados para desenvolvimento e teste. Para transformar seu dispositivo em um dispositivo de desenvolvimento e ter acesso ao app Web Receiver não publicado durante o desenvolvimento, registre o dispositivo no app. O registro também permite que o receptor seja acessível em uma janela remota do navegador para depuração. Consulte Depuração.

Para registrar seu dispositivo com Google Cast:

  1. Configure o dispositivo com Google Cast e conecte-o à mesma rede Wi-Fi que seu computador.

    Consulte as instruções de configuração do dispositivo de transmissão para ver mais informações.

  2. No computador, abra um navegador da Web compatível com Cast.

  3. Faça login no Console do desenvolvedor do SDK do Google Cast.

  4. Encontre o número de série do dispositivo que você quer registrar.

  5. Na página "Visão geral" ou "Dispositivos", clique em Adicionar novo dispositivo.

  6. Digite o número de série do dispositivo.

  7. Digite uma descrição e clique em OK.

    Esse é apenas um nome amigável para o dispositivo, não precisa corresponder ao nome que você deu ao dispositivo durante a configuração do usuário.

  8. Aguarde 15 minutos antes de continuar.

    Depois que o registro for concluído, o status do dispositivo será "Pronto para testes".

  9. Reinicie o dispositivo de transmissão: desconecte a alimentação ou o cabo USB do dispositivo e reconecte-o.

Encontrar o número de série do dispositivo

Para encontrar o número de série de qualquer dispositivo, transmita a página do Play Console para ele:

  1. Clique no botão Transmitir (como se você estivesse transmitindo esta página).

    O prompt exibe a guia Transmitir e lista os dispositivos disponíveis.

  2. No menu suspenso, selecione o dispositivo em que você quer receber o número de série.

    • Para dispositivos de exibição, o número de série é exibido na tela da TV e é lido em voz alta nos alto-falantes da TV para ajudar a remover a ambiguidade de "0" e "O".
    • Para dispositivos de áudio, o número de série é lido em voz alta no alto-falante que está sendo transmitido.

Número de série do software do Android TV

Os dispositivos Android TV (ATV) têm vários números de série associados a eles. O número de série do software (Cast) pode ser encontrado transmitindo a página do Console para desenvolvedores do Google Cast no dispositivo ATV conforme descrito acima ou colocando o dispositivo no modo de desenvolvedor e procurando nas configurações do número de série do software.

Para colocar seu dispositivo ATV no modo de desenvolvedor, navegue até Settings > System > About > Android TV OS build e clique no build várias vezes até que o dispositivo informe que você está no modo de desenvolvedor. Para encontrar o número de série uma vez no modo de desenvolvedor, acesse Configurações > Preferências do dispositivo > Chromecast integrado ou Configurações > Sistema > Transmitir, dependendo do modelo de ATV, e você verá o número de série do software.

Quando um dispositivo ATV é redefinido para a configuração original, o número de série de software é alterado. Após a redefinição para a configuração original, siga as etapas acima para encontrar o número de série de software e registrar novamente o novo número de série do dispositivo usando o Play Developer Console.

Problemas com a conta

Quero cancelar minha inscrição no Console do desenvolvedor do Google Cast

A taxa de registro da conta de desenvolvedor de US $5 não é reembolsável.

Não consigo mais acessar o Console para desenvolvedores do Google Cast

Se você recebeu um e-mail nosso informando que a conta de desenvolvedor foi suspensa devido a várias violações dos nossos Termos de Serviço ou das nossas Políticas de conteúdo, responda a este e-mail se precisar de mais esclarecimentos.

Meu app foi removido do Google Cast

Os aplicativos removidos contam como avisos que afetam a situação regular da conta de desenvolvedor. Violações recorrentes ou graves da política podem resultar no encerramento da sua conta de desenvolvedor.

Uma remoção significa que os usuários não poderão ver ou acessar o aplicativo removido. Se as credenciais de desenvolvedor ainda estiverem em situação regular com o Google Cast e a natureza do aplicativo permitir, será possível fazer correções e publicar uma nova instância em conformidade com o aplicativo.

Não publique novamente um app removido até que a violação da política tenha sido corrigida.

Quero mudar o endereço de e-mail associado à minha conta

Não é possível alterar o endereço de e-mail associado à sua conta de desenvolvedor do Google Cast. Se você trabalha para uma organização, recomendamos usar um endereço de e-mail de equipe para evitar problemas de acesso no futuro.

Tenho outro problema

Consulte a página de suporte do SDK do Cast.