Este documento aborda como usar o Google Play Console para configurar os serviços relacionados a jogos do Google Play no seu jogo Android. O Google Play Console oferece um local centralizado para você gerenciar serviços relacionados a jogos e configurar metadados para autorizar e autenticar seu jogo.
Para adicionar seu jogo ao Google Play Console, siga estas etapas gerais:
- Crie um projeto de jogo e especifique detalhes, como o nome e a descrição.
- Crie e vincule as credenciais necessárias para autorizar e autenticar seu jogo nos serviços relacionados a jogos do Google Play.
Essas etapas são abordadas com mais detalhes nas seções abaixo.
Etapa 1. Faça login no Google Play Console.
Para fazer login, acesse o Google Play Console. Se você ainda não se registrou no Google Play Console, vai receber uma solicitação para fazer isso.
Etapa 2: Adicionar seu jogo ao Google Play Console
Para adicionar seu jogo, siga estas etapas:
- Crie um jogo no Play Console, caso ainda não tenha feito isso. Clique aqui para ver mais detalhes.
- Navegue até Crescimento > Serviços relacionados a jogos do Google Play > Configuração e gerenciamento > Configuração.
Especifique qual projeto dos serviços relacionados a jogos do Google Play você quer usar: crie um do zero ou use um já existente.
Criar um novo projeto dos serviços relacionados a jogos do Google Play:é necessário ter um projeto na nuvem.
Se você já tiver um projeto de nuvem criado para este jogo, selecione seu projeto de nuvem na lista suspensa e selecione Usar.
Caso contrário, selecione Criar novo projeto na nuvem e siga as instruções para criar um novo projeto na nuvem para este jogo. Depois selecione Atualizar projetos na nuvem, escolha o projeto recém-criado na lista suspensa e clique em Usar.
Usar um projeto já existente dos serviços relacionados a jogos do Google Play:se você estiver criando um novo jogo no Play Console para mudar o nome do pacote existente ou se tiver versões sem custo financeiro e pagas do jogo com diferentes nomes de pacotes, use essa opção. Escolha o projeto dos serviços relacionados a jogos do Google Play e clique em Usar.
Um projeto de jogo dos serviços relacionados a jogos do Google Play é criado, e as APIs desses serviços são ativadas automaticamente no projeto de nuvem selecionado.
Na seção Propriedades, selecione Editar propriedades e adicione a descrição, a categoria e os recursos gráficos do jogo.
- Apenas o nome de exibição é obrigatório para testes. Os outros campos precisam ser preenchidos antes de publicar o jogo.
- O nome de exibição e a descrição do jogo precisam corresponder ao que você configurou na página "Detalhes do app" da Play Store.
- Para conferir diretrizes sobre como criar os recursos gráficos, consulte o guia do Google Play para desenvolvedores e as Diretrizes de imagens em destaque do Google Play.
Etapa 3. Gerar um ID do cliente OAuth 2.0
Seu jogo precisa ter um ID do cliente OAuth 2.0 para ser autenticado e autorizado a chamar os serviços relacionados a jogos do Google Play. Para configurar uma credencial dos serviços relacionados a jogos do Google Play, que é a associação entre um ID do cliente e o jogo, use o Google Cloud Platform. Em seguida, use o Google Play Console para adicionar uma credencial, vinculando o ID do cliente ao jogo.
Para instruções mais detalhadas, consulte as próximas etapas:
a. Configurar a tela de permissão OAuth
Se você ainda não configurou a tela de permissão OAuth, a seção Credenciais vai mostrar uma mensagem pedindo para você fazer isso.
Clique em Configurar. Isso vai abrir uma caixa de diálogo com mais instruções e um link direto para o Google Cloud Platform.
Se você tiver concluído a configuração da tela de permissão OAuth, clique em Concluído. O Google Play Console vai ser atualizado automaticamente e, se a configuração tiver sido bem-sucedida, você vai poder criar uma credencial:
b. Criar uma credencial
Para autorizar seu jogo a se comunicar com os serviços relacionados a jogos do Google Play, você precisa criar uma credencial com um ID do cliente OAuth2 autorizado.
Na seção Credenciais, clique em Adicionar credencial.
No assistente, escolha se você quer criar uma credencial do Android (se o APK do jogo autenticar o usuário e usar APIs PGS) ou uma credencial do servidor de jogos (se o servidor de jogos usar APIs PGS). Siga as instruções específicas do tipo de credencial desejado.
Android
Configurar detalhes da credencial
Confira se o nome no campo Nome corresponde ao do seu jogo. Escolha se você quer ativar o recurso Antipirataria.
Configurar autorização
Em seguida, escolha um ID do cliente OAuth para usar no projeto do jogo. Se você já tem IDs do cliente OAuth2, escolha um. No entanto, normalmente você vai precisar criar um novo. Clique em Criar um cliente OAuth. Isso vai abrir uma caixa de diálogo com links diretos e instruções para criar um ID do cliente OAuth no Google Cloud Platform.
- Selecione Android como o tipo de aplicativo.
- Digite o nome do jogo no campo Nome.
- Digite o nome do pacote do aplicativo Android no campo correspondente.
Abra um terminal e execute o utilitário Keytool para receber as impressões digitais SHA1 dos certificados de versão e depuração.
Para encontrar a impressão digital do certificado de versão, execute este comando:
keytool -list -keystore <path-to-production-keystore> -vPara encontrar a impressão digital do certificado de depuração, execute este comando:
keytool -list -keystore <path-to-debug-keystore> -vO utilitário keytool solicita que você insira uma senha para o armazenamento de chave. A senha padrão do keystore de depuração é
android. Em seguida, a keytool vai mostrar a impressão digital no terminal.Cole a impressão digital SHA1 no campo Impressão digital do certificado de autorização (SHA1).
Clique em Criar.
Para mais informações sobre o OAuth 2.0 no Android, consulte Como autenticar em serviços OAuth2.
Depois de clicar em Concluído na caixa de diálogo, os IDs do cliente disponíveis vão ser atualizados. Escolha a credencial criada no menu suspenso e clique em Salvar alterações. Isso cria a credencial como um rascunho, permitindo que você faça a autenticação dos serviços relacionados a jogos do Google Play.
Crie duas credenciais: uma com a impressão digital do certificado de versão e outra com a impressão digital do certificado de depuração. Use o mesmo nome de pacote para as duas. Isso permite que os serviços relacionados a jogos do Google Play reconheçam chamadas dos APKs vinculados que são assinados com um desses certificados. Para mais informações sobre a assinatura de certificados para Android, consulte Assinar o app.
Servidor de jogos
Configurar detalhes da credencial
Confira se o nome no campo Nome corresponde ao do seu jogo.
Configurar autorização
Em seguida, escolha um ID do cliente OAuth para usar no projeto do jogo. Se você já tem IDs do cliente OAuth2, escolha um. No entanto, normalmente você vai precisar criar um novo. Clique em Criar um cliente OAuth. Isso vai abrir uma caixa de diálogo com links diretos e instruções para criar um ID do cliente OAuth no Google Cloud Platform.
- Selecione Aplicativo da Web como o tipo de aplicativo.
- Digite o nome do jogo no campo Nome.
- Clique em Criar.
Para mais informações sobre o OAuth 2.0 no Android, consulte Como autenticar em serviços OAuth2.
Depois de clicar em Concluído na caixa de diálogo, os IDs do cliente disponíveis vão ser atualizados. Escolha a credencial criada no menu suspenso e clique em Salvar alterações. Isso cria a credencial como um rascunho, permitindo que você faça a autenticação dos serviços relacionados a jogos do Google Play no seu servidor de jogos. Consulte Como ativar o acesso do lado do servidor nos serviços relacionados a jogos do Google Play para mais informações sobre o uso desses serviços no seu servidor de jogos.
Como evitar problemas comuns de configuração
Para evitar erros comuns de configuração, siga estas recomendações ao configurar seu jogo para usar os serviços relacionados a jogos do Google Play.
- 1. Configurar o jogo com o Google Play Console
- Se você criou um ID do cliente Oauth 2.0 para seu app no Console do Google Cloud, os serviços relacionados a jogos do Google Play não saberão sobre a associação entre a conquista, os placares e o ID do cliente. Para criar essa associação, crie uma credencial usando o ID do cliente OAuth 2.0, conforme descrito em Criar uma credencial.
- 2. Use o ID do aplicativo correto no Android
- O ID do aplicativo é um recurso de string obrigatório que precisa ser referenciado no manifesto do Android. A string do ID do aplicativo consiste apenas nos dígitos (normalmente 12 ou mais) no início do ID do cliente fornecido pelo Google Play Console. O ID do aplicativo fica na parte de cima da página Configuração e é rotulado como ID do projeto abaixo do nome do jogo.
- 3. Assine o APK com o certificado correto
- Ao vincular seu app Android ao seu jogo no Google Play Console, use exatamente o mesmo nome de pacote e impressão digital do certificado usados para publicar o app. Se houver uma incompatibilidade, as chamadas para os serviços relacionados a jogos do Google Play vão falhar. Crie dois IDs do cliente, um com a impressão digital do certificado de lançamento e outro com a impressão do certificado de depuração, e use o mesmo nome de pacote para os dois. Para saber mais sobre como especificar o certificado de assinatura no Google Play Console, consulte Assinar o aplicativo.
- 4. Ao desenvolver para o Android, inclua o SDK do Play Games como um projeto de biblioteca, não como um JAR independente
- Confira se o SDK do Google Play Services está referenciado como um projeto de biblioteca no seu projeto Android. Caso contrário, isso poderá levar a erros quando o app não encontrar recursos do Google Play Services. Para saber como configurar seu projeto do Android para usar o Google Play Services, consulte Como configurar o Google Play Services.
- 5. Faça login com uma conta de testador durante o desenvolvimento
- Se você não publicou as mudanças nas configurações do jogo no Google Play Console, é possível que ocorram erros durante os testes se você não tiver feito login com uma conta de testador permitida. Sempre ative sua conta de editor do Google Play Console para testes. Para aprender a gerenciar contas de testadores, consulte Como ativar contas para testes.
- 6. Publique a tela de permissão no Google Cloud Platform
- Antes de publicar o app no Google Play Console, publique a tela de permissão no Google Cloud Platform. Sem esta etapa, o público não vai poder usar os recursos dos serviços relacionados a jogos do Google Play.
- 7. No lançamento, publique as configurações dos serviços relacionados a jogos do Google Play antes de publicar o jogo
- Os desenvolvedores podem publicar o app acidentalmente sem publicar as configurações correspondentes dos serviços relacionados a jogos do Google Play. Isso pode fazer com que os jogadores que fizerem login com contas que não sejam de teste encontrem erros, já que o app não pode referenciar as configurações corretas do jogo. Ao lançar seu jogo, lembre-se de publicar as configurações dele usando a opção Publicar jogo no Google Play Console. Para aprender a publicar as mudanças, consulte Como publicar as mudanças no jogo.
Para mais dicas, consulte:
- Guia de solução de problemas do Android: documentação do desenvolvedor que descreve como resolver problemas ao desenvolver jogos Android.
Próximas etapas
Antes de continuar, adicione contas de teste ao jogo, conforme descrito em Ativar contas para testes. Os usuários com contas de teste autorizadas terão acesso ao seu projeto não publicado dos serviços relacionados a jogos do Google Play e poderão testar se os serviços configurados estão funcionando corretamente.
Depois de concluir as tarefas de configuração inicial descritas acima, você pode prosseguir para configurar recursos para o jogo, como placares e conquistas. Para saber mais, consulte Ativar recursos.