Você precisa registrar seu aplicativo se estiver usando o Receptor de mídia estilo ou criando um Receptor personalizado. Depois de registrar seu aplicativo, você receberá um ID do aplicativo, que será usado pelo aplicativo remetente para realizar chamadas de API, como para iniciar um aplicativo receptor da Web.
Se você usar o Receptor de mídia padrão, não precisará registrar o aplicativo. O receptor de mídia padrão não permite que você forneça nenhum estilo à interface do player de mídia e usa uma constante fornecida como o ID do aplicativo.
Além disso, é preciso registrar seu dispositivo com Google Cast para que ele possa acessar seu aplicativo receptor da Web antes de publicá-lo. Após a publicação do app receptor, ele vai ficar disponível para todos os dispositivos com Google Cast.
Aplicativos
Isso permite que você o teste no dispositivo Cast registrado antes de publicar o aplicativo. Quando o app é publicado, ele fica disponível para todos os dispositivos de transmissão.
Registrar seu aplicativo
É preciso registrar um Receptor de mídia estilizado ou um Receptor personalizado para receber um ID do aplicativo usado com chamadas de API do aplicativo remetente.
Para registrar seu app Google Cast:
- Faça login no Play Console do SDK do Google Cast.
- Na página Visão geral ou na página Aplicativos, clique em Adicionar novo aplicativo.
Selecione o tipo de app receptor da Web que você vai usar:
Receptor personalizado
Selecione essa opção se o app exigir componentes de interface do usuário ou padrões de interação que não são fornecidos pelo receptor de mídia estilizado. Talvez também seja necessário selecionar o "Custom Receiver" se o tipo de conteúdo não estiver listado como um dos tipos de mídia com suporte do receptor de mídia estilizado.
Lembre-se de que essa opção requer que você crie um app da Web completo para o app receptor da Web.
Veja mais detalhes em Aplicativo receptor personalizado.
Receptor de mídia estilizado
Selecione essa opção se o app faz streaming de conteúdo de vídeo ou áudio usando um dos tipos de mídia compatíveis e você quer oferecer uma interface do usuário na TV que use a interface do player de mídia padrão ou um conjunto de estilos personalizados sobre a interface do player de mídia padrão.
Os estilos personalizados que você pode fornecer permitem definir a aparência de vários elementos da interface do player (como a tela de apresentação e a barra de progresso) simplesmente fornecendo um arquivo CSS. Não é necessário criar um app receptor.
Veja mais detalhes em Receptor de mídia estilizado.
Preencha os detalhes do seu app receptor da Web:
No campo Nome, insira o nome do seu app.
Esse é o nome do app que aparece quando o receptor da Web está carregando ou em 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 para o estado do aplicativo, se ele não estiver definido usando o método
setApplicationState.Especifique a aparência do app receptor da Web:
Para um Receptor personalizado, no campo URL, especifique o URL do app.
Insira um URL que o dispositivo com Google Cast precisa solicitar ao carregar o app receptor da Web. Durante o desenvolvimento, o URL pode usar HTTP, mas quando o app é publicado, ele precisa usar HTTPS. O URL pode ser de uma página HTML ou outro tipo de arquivo acessível em um navegador da Web. Tudo bem que o receptor da Web esteja em um endereço IP interno (registrado em NAT), mas não em um localhost, já que raramente é um domínio de nível superior. Embora o app receptor da Web precise ser exibido por SSL (HTTPS) quando publicado, o conteúdo carregado no app pode ser exibido por HTTP.
Para um Receptor de mídia estilizado, no campo URL da capa, especifique o URL da folha de estilo.
Forneça um URL HTTPS que aponte para o arquivo CSS localizado no seu próprio site. Para usar os estilos padrão, deixe o campo vazio. Você pode editar esse campo mais tarde se quiser fornecer ou atualizar seus estilos personalizados.
Marque ou deixe desmarcada a caixa de seleção Suporte à transmissão de redirecionamento.
A transmissão de redirecionamento permite que o receptor da Web ofereça suporte à transmissão de remetentes não conectados à mesma rede Wi-Fi que o receptor. Para desativar a transmissão de redirecionamento para o receptor, desmarque essa caixa.
Marque ou deixe desmarcada a caixa de seleção Compatível com transmissão para dispositivos somente de áudio.
Para permitir que seu app descubra o Google Cast para dispositivos de áudio, marque essa caixa. Para desativar o suporte a dispositivos somente de áudio, desmarque essa caixa. Consulte Dispositivos de áudio para mais informações.
Clique em Salvar.
Seus detalhes de registro, incluindo ID, nome, tipo e status do aplicativo, são exibidos. Anote o ID do aplicativo, porque ele será fornecido com as chamadas da API Cast do seu aplicativo.
Clique em Concluído para retornar à página "Aplicativos".
Editar informações do aplicativo
Antes de publicar o aplicativo, é preciso fornecer mais algumas informações. Também é possível atualizar as informações fornecidas sobre o aplicativo durante o registro.
Para editar as informações do aplicativo:
- No Play Console do SDK do Google Cast, na página Visão geral ou Aplicativos, clique no ID do aplicativo ou clique em Editar para o aplicativo que você quer editar.
- No campo Nome, atualize o nome informado quando você registrou o aplicativo.
- Para aplicativos receptores personalizados, no campo URL, atualize o local do aplicativo receptor da Web que você registrou.
- Para aplicativos "Receptor estilizado", no campo URL da capa, atualize o local da folha de estilo do aplicativo.
Marque ou deixe desmarcada a caixa de seleção Suporte à transmissão de redirecionamento.
A transmissão de redirecionamento permite que o receptor da Web ofereça suporte à transmissão de remetentes não conectados à mesma rede Wi-Fi que o receptor. Para desativar a transmissão de redirecionamento para o receptor, desmarque essa caixa.
Marque ou deixe desmarcada a caixa de seleção Suporte à transmissão para dispositivos somente de áudio.
Marque esta 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 mais informações.
Na seção Detalhes do remetente, forneça o seguinte para cada plataforma compatível com o app:
Android:
- o nome totalmente qualificado do pacote do aplicativo.
iOS:
- o ID do iTunes e o ID do pacote exigidos pela Apple.
- o URI de inicialização do app, com o URI que o app Google Home usa para iniciá-lo. Para mais informações sobre o formato de URI necessário, consulte Como usar esquemas de URL para se comunicar com apps.
Web:
- o URL do site para seu aplicativo.
Na seção Detalhes da listagem, escolha se quer listar seu app nos Serviços do Google, como chromecast.com/apps..
No menu suspenso Categoria, selecione a categoria que melhor descreve o aplicativo.
Observação:o 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 o 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 as disposições para a reprodução de vídeos.
Para descrever os países em que seu app está disponível, selecione o botão de opção Todos os países ou Somente em países selecionados. Se especificar países, marque as caixas desses países na lista exibida.
No campo Título, forneça um título descritivo para o aplicativo.
Use até 50 caracteres. Por exemplo, "YouTube".
No campo Descrição, insira uma descrição para o aplicativo.
Use até 80 caracteres. Por exemplo, "Aproveite seus canais favoritos do YouTube na melhor tela da casa".
Na seção Gráficos, clique no sinal de adição para fazer upload da imagem do ícone para o aplicativo.
A imagem precisa ter 512 x 512 pixels e um plano de fundo transparente.
Em Add Your Own Traduções, se você quiser fornecer traduções para os campos Título e Descrição, selecione o idioma no menu suspenso, clique em Adicionar e insira o texto traduzido na caixa de diálogo exibida. Também é possível fazer upload de uma imagem para o ícone específico dessa tradução.
Quando terminar de atualizar as informações do aplicativo, clique em Salvar.
Publicar seu aplicativo
A publicação do app o disponibiliza para todos os dispositivos de transmissão no mundo todo. Ela também cria uma página de detalhes para seu app nos Serviços do Google, como o site de informações do produto chromecast.com/apps, em que os usuários podem descobrir e fazer o download do seu app. Se você optou por listar seu app quando editou as informações dele na etapa 6, acima, ele vai aparecer em chromecast.com/apps assim que for publicado.
Para publicar o aplicativo:
No Play Console 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 será exibida com as informações do aplicativo inseridas em Editar informações do aplicativo. Caso contrário, aparecerá uma mensagem citando as informações que você precisa fornecer.
Clique em Editar para voltar e atualizar as informações.
Quando estiver tudo pronto para publicar o app, clique em Publicar.
Estatísticas
O Play Console do SDK do Google Cast monitora o desempenho do seu aplicativo. Para cada aplicativo publicado na página "Aplicativos" ou "Visão geral", é possível ver os dados de desempenho clicando em Visualizar na coluna Estatísticas.
As seguintes informações são apresentadas:
- Número de receptores do 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 Other aparecer nas estatísticas, isso significa que o remetente não indicou sua plataforma. Por exemplo, se um remetente do iOS mais antigo não tiver sido atualizado.
Dispositivos
Por padrão, os dispositivos com Google Cast (como o Chromecast ou Android TV) não estão habilitados para desenvolvimento e testes. Para transformar seu dispositivo em um dispositivo de desenvolvimento e ter acesso ao app receptor da Web não publicado durante o desenvolvimento, é necessário registrá-lo no app. O registro também permite que o receptor seja acessado em uma janela do navegador remoto para depuração (consulte Depuração).
Para registrar seu dispositivo com Google Cast:
Configure o dispositivo com Google Cast e conecte-o à mesma rede Wi-Fi que o computador.
Consulte as instruções de Configuração do dispositivo de transmissão para mais informações.
No computador, abra um navegador da Web compatível com Cast.
Faça login no Play Console do SDK do Google Cast.
Encontre o número de série do dispositivo que você quer registrar.
Na página "Visão geral" ou "Dispositivos", clique em Adicionar novo dispositivo.
Digite o número de série do dispositivo.
Digite uma descrição e clique em OK.
Esse é apenas um nome amigável para seu dispositivo. Ele não precisa corresponder ao nome que você deu ao dispositivo durante a configuração do usuário.
Aguarde quinze minutos antes de continuar.
Quando o registro estiver concluído, o status do dispositivo será "Pronto para teste".
Reinicie seu dispositivo de transmissão: desconecte o cabo USB ou de alimentação 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 Google Cast Console para o dispositivo:
Clique no botão Transmitir (como se estivesse transmitindo esta página).
O comando vai mostrar a guia Transmitir e listar os dispositivos disponíveis.
No menu suspenso, selecione o dispositivo em que você quer ter 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 eliminar a ambiguidade dos zeros 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 Play Console para o dispositivo ATV, conforme descrito acima, ou colocando o dispositivo ATV no modo de desenvolvedor e procurando o número de série do software nas configurações de transmissão.
Para colocar o dispositivo ATV no modo de desenvolvedor, acesse Configurações > Sistema > Sobre > Build do SO do Android TV e clique no build várias vezes até que o dispositivo notifique que você está no modo de desenvolvedor. Para encontrar o número de série no modo de desenvolvedor, acesse Configurações > Preferências do dispositivo > Chromecast built-in ou Configurações > Sistema > Transmissão, dependendo do modelo do ATV. O número de série do software vai aparecer.
Quando um dispositivo ATV é redefinido para a configuração original, o número de série do software muda. Após uma redefinição para a configuração original, siga as etapas acima para encontrar o número de série do software e registrar novamente o novo número de série do software do dispositivo com o Console para desenvolvedores do Google Cast.
Problemas com a conta
Quero cancelar meu registro no Console do desenvolvedor do Google Cast
A taxa de registro da conta de desenvolvedor de US $5 não é reembolsável.
Não tenho mais acesso ao Google Cast Console
Se você já recebeu um e-mail informando que sua conta de desenvolvedor foi suspensa devido a várias violações dos nossos Termos de Serviço ou das Políticas de conteúdo, responda a esse e-mail se precisar de mais esclarecimentos.
Meu app foi removido do Google Cast
Os apps removidos contam como avisos que afetam a situação regular da sua conta de desenvolvedor. Muitas violações ou violações graves das políticas podem resultar no encerramento da sua conta de desenvolvedor.
Uma remoção significa que os usuários não conseguirão ver nem acessar o aplicativo removido. Se suas credenciais de desenvolvedor ainda estiverem em situação regular com o Google Cast e a natureza do seu aplicativo permitir, faça correções e publique uma nova instância do aplicativo em conformidade.
Não publique novamente um aplicativo removido até que a violação da política tenha sido remediada.
Quero alterar 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.