Você precisa registrar seu aplicativo se estiver usando o receptor de mídia estilizado ou criando um receptor personalizado. Depois de registrar seu aplicativo, você vai receber um ID do aplicativo, que é usado pelo app remetente para realizar chamadas de API, como iniciar um app receptor da Web.
Se você usar o receptor de mídia padrão, não será necessário registrar o aplicativo. O receptor de mídia padrão não permite que você estilize a IU do player de mídia e usa uma constante fornecida como o ID do aplicativo.
Além disso, é necessário registrar o dispositivo Google Cast para que ele possa acessar o aplicativo Web Receiver antes da publicação. Depois de publicar o aplicativo receptor, ele vai estar disponível para todos os dispositivos Google Cast.
Aplicativos
Ao registrar o aplicativo, você pode testá-lo no dispositivo Cast registrado antes de publicá-lo. A publicação do aplicativo o disponibiliza para todos os dispositivos Cast.
Registrar o aplicativo
É necessário registrar um receptor de mídia estilizado ou um receptor personalizado para receber um ID do aplicativo que será usado com chamadas de API do aplicativo remetente.
Para registrar seu aplicativo do 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 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. Selecionar o receptor personalizado também pode ser necessário se o tipo de conteúdo não estiver listado como um dos tipos de mídia compatíveis do receptor de mídia estilizado.
Essa opção exige 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 padrão do player de mídia.
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.
Para mais detalhes, leia Receptor de mídia estilizado.
Preencha os detalhes do seu app receptor da Web:
No campo Nome, insira o nome do app.
Esse é o nome do aplicativo que aparece quando o receptor da Web está carregando 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 para o estado do aplicativo, se ele não for 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 aplicativo.
Insira um URL que o dispositivo Google Cast deve solicitar ao carregar seu app receptor da Web. Durante o desenvolvimento, o URL pode usar HTTP, mas, quando o app for publicado, ele precisará 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 o receptor da Web estar em um endereço IP interno (registrado em NAT), mas não em localhost, já que raramente é um domínio de nível superior. Embora o app receptor da Web precise ser disponibilizado por SSL (HTTPS) quando publicado, o conteúdo carregado no app receptor da Web pode ser disponibilizado 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 site. Para usar os estilos padrão, deixe o campo vazio. Você pode editar isso mais tarde se quiser fornecer ou atualizar seus estilos personalizados.
Marque ou deixe desmarcada a caixa de seleção Compatível com transmissão por retransmissão.
A transmissão por redirecionamento permite que o Web Receiver aceite transmissões de remetentes que não estão conectados à mesma rede Wi-Fi que o receptor. Para desativar a transmissão de retransmissão para o receptor, desmarque essa caixa.
Marque ou desmarque a caixa de seleção Permite transmissão para dispositivos somente de áudio.
Para permitir que o app descubra dispositivos de áudio com Google Cast, 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 registro, incluindo o ID do aplicativo, o nome, o tipo e o status, são exibidos. Anote o ID do aplicativo, porque você vai precisar dele nas chamadas de API do 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 algumas informações adicionais. Você também pode atualizar as informações fornecidas sobre o aplicativo durante o registro.
Para editar as informações do aplicativo:
- No Google Cast SDK Developer Console, na página Visão geral ou Aplicativos, clique no ID do aplicativo ou em Editar para o 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 da capa, atualize o local da folha de estilo do aplicativo.
Marque ou deixe desmarcada a caixa de seleção Compatível com transmissão por retransmissão.
A transmissão por redirecionamento permite que o receptor da Web aceite transmissões de remetentes que não estão conectados à mesma rede Wi-Fi que o receptor. Para desativar a transmissão por retransmissão no receptor, desmarque essa caixa.
Marque ou deixe desmarcada a caixa de seleção Permite a transmissão para dispositivos somente de áudio.
Para permitir que seu app descubra dispositivos de áudio do Google Cast, marque esta caixa. 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 as seguintes informações 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, 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 quer listar seu aplicativo em Serviços do Google, como chromecast.com/apps.
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, além daqueles implícitos em 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á ser compatível com dispositivos somente de áudio, conforme descrito em Dispositivos de áudio, além das 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 nos países selecionados. Se especificar os países, marque as caixas deles 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 aplicativo.
Use até 80 caracteres. Por exemplo, "Curta 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 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. 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
Ao publicar seu aplicativo, ele fica disponível para todos os dispositivos Cast no mundo todo. Ele também cria uma página de detalhes para seu aplicativo nos Serviços do Google, como o site chromecast.com/apps, em que os usuários podem descobrir e fazer o download do app. Se você optou por listar seu app ao editar as informações do aplicativo na etapa 6 acima, ele vai aparecer em chromecast.com/apps depois de publicado.
Para publicar o aplicativo:
No Google Cast SDK Developer 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 aplicativo, clique em Publicar.
Estatísticas
O Google Cast SDK Developer Console monitora o desempenho do seu aplicativo. Para cada aplicativo publicado na página "Aplicativos" ou "Visão geral", é possível ver os dados de performance 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 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 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 app receptor da Web não publicado durante o desenvolvimento, registre o dispositivo com seu app. O registro também permite que o receptor seja acessado em uma janela de navegador remota 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 para mais informações.
No computador, abra um navegador da Web compatível com o Google Cast.
Faça login no Google Cast SDK Developer Console.
Encontre o número de série do dispositivo que você quer registrar.
Na página de visão geral ou de dispositivos, clique em Adicionar novo dispositivo.
Insira 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 (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 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 Cast Developer Console para ele:
Clique no botão Transmitir (como se estivesse transmitindo esta página).
O prompt mostra a guia de transmissão e lista os dispositivos disponíveis.
No menu suspenso, selecione o dispositivo do qual você quer obter 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 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 obtido transmitindo a página do Console para desenvolvedores do Cast 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, acesse Configurações > Sistema > Sobre > Versão do SO Android TV e clique na versão 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 > Google Cast ou Configurações > Sistema > Cast, 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 de fábrica, siga as etapas acima para encontrar o número de série do software e registre o novo número de série do software do dispositivo no Cast Developer Console.
Problemas com a conta
Quero cancelar meu registro no Google Cast Developer Console
A taxa de registro de US $5 da conta de desenvolvedor não é reembolsável.
Não consigo mais acessar o Console para Desenvolvedores do Google Cast
Se você já recebeu um e-mail nosso 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. Violações graves ou recorrentes 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. Se as suas credenciais de desenvolvedor ainda estiverem em situação regular com o Google Cast e a natureza do seu aplicativo permitir, você poderá fazer correções e publicar uma nova instância do aplicativo em conformidade com as políticas.
Não publique novamente um aplicativo 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 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 da equipe para evitar problemas de acesso no futuro.
Tenho outro problema
Consulte a página de suporte do SDK do Cast.