É necessário registrar 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 do aplicativo, que será usado pelo aplicativo remetente para realizar chamadas de API, por exemplo, para iniciar um aplicativo receptor da Web.
Se você usar o Receptor de mídia padrão, não será necessário registrar seu aplicativo. O receptor de mídia padrão não permite que você forneça nenhum estilo para a interface 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 seu aplicativo receptor da Web antes de publicá-lo. Após a publicação, o app receptor vai ficar disponível para todos os dispositivos com Google Cast.
Aplicativos
Registrar o aplicativo permite testá-lo no dispositivo de transmissão registrado antes de publicar o aplicativo. Após a publicação, o app fica disponível para todos os dispositivos de transmissão.
Registrar o aplicativo
É necessário registrar um Receptor de mídia estilizado ou um Receptor personalizado para receber um ID de aplicativo usado com chamadas de API do aplicativo remetente.
Para registrar seu aplicativo Google Cast:
- Faça login no Play Console do SDK do Google Cast.
- Na página Visão geral ou Aplicativos, clique em Adicionar novo aplicativo.
Selecione o tipo de app receptor da Web que você 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 receptor de mídia estilizado. Também pode ser necessário selecionar um receptor personalizado se o tipo de conteúdo não está listado como um dos tipos de mídia compatíveis com o receptor de mídia estilizado.
Essa opção requer que você crie um app da Web completo para o app receptor da Web.
Para mais 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 interface padrão do player de mídia 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 jogador (como a tela de apresentação e a barra de progresso) simplesmente fornecendo um arquivo CSS. Não é necessário criar um app receptor.
Confira mais detalhes em Receptor de mídia estilizado.
Preencha os detalhes do seu app receptor da Web:
No campo Nome, digite o nome do app.
Esse é o nome do aplicativo que aparece quando o receptor da Web está sendo carregado ou no estado inativo, se você está 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 for definido com 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 deve solicitar ao carregar seu 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 que pode ser acessado em um navegador da Web. Não há problema que o Web Receiver 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 veiculado por SSL (HTTPS) quando publicado, o conteúdo carregado nele pode ser exibido por HTTP.
Para um Receptor de mídia estilizada, no campo URL de tema, especifique o URL para a folha de estilos.
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 em branco. É possível editar esse campo a qualquer momento se você quiser fornecer ou atualizar seus estilos personalizados.
Marque ou deixe desmarcada a caixa de seleção Oferece suporte à transmissão de redirecionamento.
A transmissão por 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 Oferece suporte à transmissão para dispositivos somente de áudio.
Para permitir que seu app descubra 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.
Os detalhes do seu registro, incluindo o ID, nome, tipo e status do aplicativo, são exibidos. Anote o ID do aplicativo para usá-lo 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, você precisa fornecer mais algumas informações. Você também pode atualizar as informações fornecidas sobre sua inscrição durante o registro.
Para editar as informações do aplicativo:
- No Play Console do SDK do Google Cast, da página Visão geral ou da página Aplicativos, clique no ID do aplicativo ou clique em Editar no aplicativo que você quer editar.
- No campo Nome, atualize o nome que você forneceu ao registrar o aplicativo.
- Para aplicativos de receptor personalizado, no campo URL, atualize o local do aplicativo receptor da Web que você registrou.
- Para aplicativos de receptor estilizado, no campo URL de tema, atualize o local da folha de estilo do seu aplicativo.
Marque ou deixe desmarcada a caixa de seleção Oferece suporte à transmissão de redirecionamento.
A transmissão por redirecionamento permite que seu 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 do redirecionamento para o receptor, desmarque essa caixa.
Marque ou deixe desmarcada a caixa de seleção Oferece 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 esta 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 pelo URI usado pelo app Google Home para iniciar o app. Para mais informações sobre o formato de URI necessário, consulte 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 nos Serviços do Google, como chromecast.com/apps..
No menu suspenso Category, selecione a categoria que melhor descreve seu aplicativo.
Observação:seu app precisa oferecer suporte aos tipos de mídia descritos aqui, bem como aos implícitos por outras configurações. Por exemplo, se o app oferecer suporte ao Google Cast para áudio e você selecionar "TV e filmes", ele precisará oferecer suporte a dispositivos somente de áudio, conforme descrito em Dispositivos de áudio, bem como as 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. Para especificar os países, marque as caixas deles na lista exibida.
No campo Title, 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, "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 app.
A imagem precisa ter 512 x 512 pixels e pode ter um plano de fundo transparente.
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 digite o texto traduzido na caixa de diálogo que aparece. 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
Após a publicação, o aplicativo fica disponível para todos os dispositivos de transmissão no mundo todo. Ele também cria uma listagem para seu aplicativo nos Serviços do Google, como o site de informações do produto chromecast.com/apps, em que os usuários podem encontrar e fazer o download do seu app. Se você optou por listar seu app quando editou as informações na etapa 6 acima, ele será exibido em chromecast.com/apps assim que for publicado.
Para publicar o aplicativo:
No Play Console do SDK do Google Cast, na página Visão geral ou Aplicativos, clique em Publicar.
Se as informações do aplicativo estiverem completas, uma tela de visualização será exibida com as informações do aplicativo que você inseriu 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 aplicativo, 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", você pode 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 app
- 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, isso significa que o remetente não indicou a plataforma dele. Por exemplo, se um remetente iOS mais antigo não tiver sido atualizado.
Dispositivos
Por padrão, os dispositivos com Google Cast (como um Chromecast ou um dispositivo Android TV) não estão ativados para desenvolvimento e teste. Para transformar seu dispositivo em um dispositivo de desenvolvimento e ter acesso ao seu app receptor da Web não publicado durante o desenvolvimento, é necessário registrar o dispositivo no seu app. O registro também permite que o receptor seja acessível em uma janela de navegador remota para depuração. Consulte Depuração.
Para registrar seu dispositivo com Google Cast:
Configure seu dispositivo com Google Cast e conecte-o à mesma rede Wi-Fi do seu 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 simples para seu dispositivo. Ele não precisa corresponder 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 testes".
Reinicie o dispositivo de transmissão: desconecte o cabo USB ou de alimentação 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 do Google Cast para o dispositivo:
Clique no botão Transmitir (como se você estivesse transmitindo a página).
A solicitação exibe Transmitir guia e lista os dispositivos disponíveis.
No menu suspenso, selecione o dispositivo de que você quer ter 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 eliminar 0s e Os).
- 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 (Google Cast) pode ser obtido 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 do Google Cast.
Para colocar o dispositivo ATV no modo de desenvolvedor, navegue até Configurações > Sistema > Sobre > Versão do SO Android TV e clique no build várias vezes até que o dispositivo notifique você que 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 built-in ou Configurações > Sistema > Transmitir, 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 no Console para desenvolvedores do 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 consigo mais acessar o Console do desenvolvedor do Google Cast
Se você 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
Aplicativos removidos contam como avisos que afetam a situação regular da sua conta de desenvolvedor. Várias ou graves violações da política podem resultar no encerramento da sua conta de desenvolvedor.
Uma remoção significa que os usuários não poderão visualizar ou acessar o aplicativo removido. Caso suas credenciais de desenvolvedor ainda estejam em situação regular com o Google Cast e a natureza do aplicativo permita isso, é possível fazer correções e publicar uma nova instância compatível do aplicativo.
Não publique novamente um aplicativo removido até que a violação da política tenha sido corrigida.
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 em 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.