Você precisa registrar seu aplicativo se estiver usando o Styled Media Receiver ou criando um Custom Receiver. Depois de registrar o aplicativo, você vai receber um ID de aplicativo, que é usado pelo aplicativo remetente para realizar chamadas de API, como para iniciar um aplicativo receptor da Web.
Se você usar o Media Receiver padrão, não será necessário registrar seu aplicativo. O Media Receiver padrão não permite que você forneça nenhum estilo à interface do media player e usa uma constante fornecida como o ID do aplicativo.
Além disso, você precisa registrar seu dispositivo com Google Cast para que ele possa acessar o aplicativo Web Receiver antes de publicar. Após a publicação, o aplicativo fica disponível para todos os dispositivos com Google Cast.
Aplicativos
O registro do aplicativo permite testá-lo com o dispositivo Cast registrado antes de publicar o aplicativo. A publicação do aplicativo o torna disponível para todos os dispositivos com Google Cast.
Registrar o aplicativo
Você precisa registrar um Styled Media Receiver ou um Custom Receiver para receber um ID de aplicativo que é usado com chamadas de API do aplicativo remetente.
Para registrar seu app do Google Cast:
- Faça login no Google Cast SDK Developer Console.
- Na página Visão geral ou Aplicativos, clique em Adicionar novo aplicativo.
Selecione o tipo de app de receptor da Web que você vai usar:
Receptor personalizado
Selecione essa opção se o app exigir componentes da interface do usuário ou padrões de interação que não são fornecidos pelo Styled Media Receiver. A seleção de um receptor personalizado também pode ser necessária se o tipo de conteúdo não estiver listado como um dos tipos de mídia com suporte do Styled Media Receiver.
Essa opção exige que você crie um app da Web completo para o app Web Receiver.
Para saber mais, leia Aplicativo de receptor personalizado.
Styled Media Receiver
Selecione essa opção se o app transmitir conteúdo de vídeo ou áudio usando um dos tipos de mídia aceitos e você quiser fornecer 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) basta fornecer um arquivo CSS. Não é necessário criar um app receptor.
Para mais detalhes, leia Styled Media Receiver.
Preencha os detalhes do app Web Receiver:
No campo Nome, insira o nome do app.
Esse é o nome do aplicativo conforme aparece quando o Web Receiver está sendo carregado ou no estado inativo, se você estiver usando o Styled Media Receiver. Se você estiver usando um receptor personalizado, o valor desse campo será o valor padrão do estado do aplicativo, se não for definido usando o método
setApplicationState.Especifique a aparência do app Web Receiver:
Para um receptor personalizado, especifique o URL do app no campo URL.
Insira um URL que o dispositivo Google Cast precisa solicitar ao carregar o app do Web Receiver. 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 de outro tipo de arquivo acessível em um navegador da Web. Não há problema em que o Web Receiver esteja em um endereço IP interno (registrado pelo NAT), mas não no localhost, já que ele raramente é um domínio de nível superior. Embora o app Web Receiver precise ser veiculado por SSL (HTTPS) quando publicado, o conteúdo carregado no app Web Receiver pode ser veiculado por HTTP.
Para um Styled Media Receiver, especifique o URL da folha de estilo no campo Skin URL.
Forneça um URL HTTPS que aponte para o arquivo CSS localizado no seu site. Para usar os estilos padrão, deixe o campo em branco. Você pode editar isso mais tarde se quiser fornecer ou atualizar seus estilos personalizados.
Marque ou desmarque a caixa de seleção Suporte para transmissão de retransmissão.
A transmissão de retransmissão permite que o receptor da Web ofereça suporte à transmissão de remetentes não conectados à mesma rede Wi-Fi do receptor. Para desativar a transmissão retransmitida para o receptor, desmarque essa caixa.
Marque ou desmarque a caixa de seleção Suporte a transmissão para dispositivos somente de áudio.
Para permitir que o app detecte o Google Cast para dispositivos de áudio, marque esta 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 o ID, o nome, o tipo e o status do aplicativo, são exibidos. Anote o ID do aplicativo, porque você vai fornecê-lo com as chamadas da API Cast do seu app.
Clique em Concluído para retornar à página "Aplicativos".
Editar informações do aplicativo
Antes de publicar seu aplicativo, você precisa fornecer mais informações. Você também pode atualizar as informações fornecidas sobre sua solicitação durante o registro.
Para editar as informações do aplicativo:
- No Play Console do Google Cast SDK, na página Visão geral ou Aplicativos, clique em ID do aplicativo ou em Editar para o aplicativo que você quer editar.
- No campo Nome, atualize o nome que você informou ao registrar o aplicativo.
- Para aplicativos de receptor personalizado, no campo URL, atualize o local do aplicativo de receptor da Web que você registrou.
- Para aplicativos Styled Receiver, no campo Skin URL, atualize o local da folha de estilo do aplicativo.
Marque ou desmarque a caixa de seleção Suporte para transmissão de retransmissão.
A transmissão por retransmissão permite que o Web Receiver ofereça suporte à transmissão de remetentes não conectados à mesma rede Wi-Fi do receptor. Para desativar a transmissão de retransmissão para o receptor, desmarque essa caixa.
Marque ou desmarque a caixa de seleção Suporte para transmissão para dispositivos somente de áudio.
Marque esta caixa para permitir que o app detecte 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 com suporte do 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, usando o URI que o app Google Home usa para iniciar seu app. 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 do seu aplicativo.
Na seção Detalhes da listagem, escolha se você quer listar seu aplicativo em propriedades do Google, como chromecast.com/apps.
No menu suspenso Categoria, selecione a categoria que melhor descreve seu app.
Observação:o app precisa oferecer suporte aos tipos de mídia descritos aqui, bem como aqueles implícitos em outras configurações. Por exemplo, se o app oferece suporte ao Google Cast para áudio e você seleciona "TV e filmes" aqui, o app precisa oferecer suporte a dispositivos somente áudio, conforme descrito em Dispositivos de áudio, bem como às disposições para reprodução de vídeo.
Para descrever os países em que o app está disponível, selecione o botão de opção Todos os países ou Somente em países selecionados. Se você especificar países, marque as caixas de seleção desses países na lista que aparece.
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 app.
Use até 80 caracteres. Por exemplo, "Curta seus canais favoritos do YouTube na melhor tela da casa".
Na seção Graphics, clique no sinal de adição para fazer upload da imagem do ícone do aplicativo.
A imagem precisa ter 512 x 512 pixels e pode ter um plano de fundo transparente.
Em Adicionar suas próprias 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 que aparece. Você também pode 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 Cast do mundo. Ele também cria uma listagem para seu aplicativo em propriedades do Google, como o site de listagem chromecast.com/apps, em que os usuários podem descobrir e fazer o download do app. Se você escolheu listar o app ao editar as informações dele na etapa 6, ele vai aparecer em chromecast.com/apps assim que for publicado.
Para publicar seu aplicativo:
No Google Cast SDK Console, na página Visão geral ou Aplicativos, clique em Publicar para o aplicativo que você quer publicar.
Se as informações do aplicativo estiverem completas, uma tela de visualização vai aparecer com as informações que você inseriu em Editar informações do aplicativo. Caso contrário, uma mensagem vai aparecer citando as informações que você precisa fornecer.
Clique em Editar para voltar e atualizar as informações.
Se 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 conferir 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 Outra aparecer nas estatísticas, significa que o remetente não indicou a plataforma. Por exemplo, se um remetente do iOS mais antigo não tiver sido atualizado.
Dispositivos
Por padrão, os dispositivos Google Cast (como um Chromecast ou um dispositivo Android TV) não são ativados para desenvolvimento e teste. Para transformar seu dispositivo em um de desenvolvimento e ter acesso ao app de Web Receiver não publicado durante o desenvolvimento, você precisa registrar o dispositivo com o 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 Google Cast:
Configure o dispositivo Google Cast e conecte-o à mesma rede Wi-Fi do computador.
Consulte as instruções de Configuração do dispositivo de transmissão em Chromecast para mais informações.
No computador, abra um navegador da Web com suporte ao Google Cast.
Faça login no Google Cast SDK Console.
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 o dispositivo. Ele não precisa ser igual ao nome que você deu ao dispositivo durante a configuração do usuário.
Aguarde 15 minutos antes de continuar.
Quando o registro for concluído, o status do dispositivo será "Pronto para teste".
Reinicie o dispositivo de transmissão: desconecte o cabo de alimentação ou USB do dispositivo e conecte novamente.
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 do Cast para o dispositivo:
Clique no botão "Transmitir" (como se você estivesse transmitindo esta página).
O comando mostra a guia "Transmitir" e lista os dispositivos disponíveis.
No menu suspenso, selecione o dispositivo para o qual você quer extrair o número de série.
- Para dispositivos de exibição, o número de série aparece na tela da TV e é lido em voz alta nos alto-falantes da TV (para ajudar a diferenciar 0s e Os).
- Para dispositivos de áudio, o número de série é lido em voz alta no alto-falante para o qual o conteúdo 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 Cast Developer 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 do Cast.
Para colocar o dispositivo ATV no modo de desenvolvedor, navegue até Configurações > Sistema > Sobre > Versão do Android TV OS 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 integrado ou Configurações > Sistema > Transmitir, dependendo do modelo do Android TV. 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. Depois de redefinir 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 no Play Console do desenvolvedor do Google Cast.
Problemas com a conta
Quero cancelar meu registro no Play Console do Google Cast
A taxa de registro da conta de desenvolvedor de US $5 não é reembolsável.
Não consigo mais acessar o Play Console do Google Cast
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
As remoções de apps contam como avisos que afetam a situação regular da sua conta de desenvolvedor. Várias violações ou violações graves das políticas podem resultar no encerramento da sua conta de desenvolvedor.
Isso significa que os usuários não poderão acessar o aplicativo removido. Caso suas credenciais de desenvolvedor ainda estejam em situação regular com o Google Cast e a natureza do seu app permita isso, você poderá 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 seja corrigida.
Quero mudar o endereço de e-mail associado à minha conta
Não é possível mudar 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 Google Cast.