Primeiros passos com os serviços relacionados a jogos do Google Play para Android

Bem-vindo ao desenvolvimento de jogos para Android com os serviços relacionados a jogos do Google Play.

O SDK do Play Games fornece serviços relacionados a jogos do Google Play em várias plataformas. Com eles, é possível integrar facilmente recursos muito usados em jogos, como conquistas, placares, jogos salvos e multijogador em tempo real (no Android) para jogos de tablet e dispositivos móveis.

Este treinamento orientará você durante a instalação de um exemplo de jogo para Android e oferecerá os conhecimentos básicos para que você possa criar seu próprio jogo para Android. O aplicativo de exemplo Type-a-Number Challenge demonstra como integrar conquistas e placares no seu jogo.

Antes de começar

• Configure o ambiente de desenvolvimento do Android. Se você for novo no desenvolvimento de apps para Android, consulte Como criar seu primeiro app.
• É preciso ter um dispositivo com Android 4.0 (Ice Cream Sandwich) ou posterior para fazer testes.

Etapa 1: fazer o download do app de exemplo

Neste guia do desenvolvedor, será necessário fazer o download do app Android de exemplo Type-a-Number Challenge.

Para fazer o download e configurar o aplicativo de exemplo no Android Studio:

1. Faça o download dos exemplos para Android na página de download de exemplos.
2. Importe o projeto android-basic-samples. Esse projeto inclui TypeANumber e outros exemplos de jogos para Android. Para fazer isso no Android Studio:
   1. Clique em Arquivo > Importar projeto.
   2. Navegue até o diretório para onde você fez o download de android-basic-samples na sua máquina de desenvolvimento. Selecione o arquivo android-basic-samples/build.gradle e clique em OK.
3. No módulo TypeANumber, abra AndroidManifest.xml e altere o nome do pacote de com.google.example.games.tanc para um nome diferente. O novo nome do pacote não pode começar com com.google , com.example nem com.android.

Etapa 2: configurar o jogo no Google Play Console

No Google Play Console, você pode gerenciar os serviços relacionados a jogos do Google Play e configurar metadados para autorizar e autenticar seu jogo.

Para configurar o jogo de exemplo no Google Play Console:

1. Acesse o Google Play Console no seu navegador e faça login. Caso ainda não tenha se registrado no Google Play Console, você receberá uma solicitação para fazer isso.
2. Siga estas instruções para adicionar seu jogo ao Google Play Console.
   1. Quando aparecer a pergunta sobre se você usa APIs do Google no aplicativo, selecione Ainda não utilizo APIs do Google em meu jogo.
   2. Neste guia do desenvolvedor, você pode preencher o formulário com os detalhes do seu próprio jogo. Para facilitar, você pode usar os ícones de marcação e as capturas de tela fornecidas na página de downloads.
3. Siga estas instruções para gerar um ID de cliente do OAuth 2.0 para seu app Android.
   1. Ao vincular seu app para Android, especifique o nome do pacote exato que usou anteriormente ao renomear o pacote do exemplo.
   2. Você pode usar o assistente "Gerar APK assinado" no Android Studio para gerar uma nova keystore e um certificado assinado, caso ainda não tenha feito isso. Para saber como usar o assistente "Gerar APK assinado", consulte Assinatura do aplicativo no Android Studio.
4. Certifique-se de registrar as seguintes informações para mais tarde:
   1. ID do aplicativo: essa é uma string que contém somente dígitos (normalmente 12 ou mais) no início do seu ID de cliente.
   2. Certificado de assinatura: anote o certificado que você usou ao configurar o acesso à API (o certificado da impressão digital SHA1 que você forneceu). Será necessário usar o mesmo certificado para assinar o app ao testá-lo ou lançá-lo.
5. Configure conquistas para Type-a-Number Challenge:
   1. Selecione a guia Conquistas no Google Play Console.
   2. Adicione os seguintes exemplos de conquistas:

      Nome	Descrição	Instruções especiais
      Primo	Alcance uma pontuação que seja um número primo.	Nenhum
      Modesto	Precisa de uma pontuação de 0.	Nenhum
      Não fique se achando	Precisa de uma pontuação de 9.999 em qualquer modo.	Nenhum
      OMG U R TEH UBER LEET!	Recebe uma pontuação de 1.337.	Torne essa conquista oculta.
      Tédio	Jogue 10 vezes.	Torne essa uma conquista incremental com 10 passos a desbloquear.
      Tédio imenso	Jogue 100 vezes.	Torne essa uma conquista incremental com 100 passos a desbloquear.

   3. Registre os códigos (strings alfanuméricas longas) de cada conquista criada.
   4. Configure as conquistas que sejam apropriadas para o seu jogo. Para saber mais, consulte os conceitos por trás de conquistas e como implementar conquistas no Android.
6. Configure os placares de líderes para Type-a-Number Challenge:
   1. Selecione a guia de Placares no Google Play Console.
   2. Adicione dois exemplos de placares: um chamado “Pontuações fáceis” e outro chamado “Pontuações difíceis”. Os dois placares devem usar formatação de pontuação de número inteiro com 0 casas decimais e o tipo de ordenação Maior é melhor.
   3. Registre os códigos (strings alfanuméricas longas) para cada placar de líderes que criou.
   4. Configure os placares de líderes que sejam apropriados para o seu jogo. Para saber mais, consulte os conceitos por trás de placares e como implementar placares no Android.
7. Adicione contas de teste ao jogo. Essa etapa é necessária somente para apps que ainda não foram publicados no Google Play Console. Antes da publicação, somente as contas de teste listadas no Google Play Console podem fazer login. No entanto, depois que o app é publicado, todos têm permissão para fazer login.

Aviso: se você tentar fazer chamadas do SDK do Play Games para um jogo não publicado usando uma conta que não esteja listada para testes, os serviços relacionados a jogos do Google Play se comportarão como se o jogo não existisse, e você receberá o código de retorno ConnectionResult.SIGN_IN_REQUIRED. Se tentar iniciar ConnectionResult.startResolutionForResult(), você receberá GamesActivityResultCodes.RESULT_SIGN_IN_FAILED.

Etapa 3: modificar seu código

Para executar o jogo, é preciso configurar o ID do aplicativo como um recurso no projeto do Android. Você também precisará adicionar os metadados do jogo a AndroidManifest.xml.

1. Abra res/values/ids.xml e substitua os códigos de marcador. Se você estiver criando um jogo para Android do início, primeiro será preciso criar esse arquivo.
   1. Especifique o ID do aplicativo no recurso app_id.
   2. Especifique todos os códigos de conquista criados anteriormente no recurso achievement_* correspondente.
   3. Especifique todos os códigos de placar criados anteriormente no recurso leaderboard_* correspondente.
2. Abra AndroidManifest.xml e insira o nome do pacote no atributo package do elemento <manifest>. Se você estiver criando um jogo para Android do início, adicione também o seguinte código ao elemento <application>:

   <meta-data android:name="com.google.android.gms.games.APP_ID"
       android:value="@string/app_id" />
   <meta-data android:name="com.google.android.gms.version"
      android:value="@integer/google_play_services_version"/>
   

Etapa 4: testar o jogo

Para verificar se os serviços relacionados a jogos do Google Play estão funcionando corretamente no seu jogo, teste o app antes de publicá-lo no Google Play.

Observação: é recomendável fazer testes em um dispositivo Android físico.No entanto, se você não tiver um dispositivo físico, teste no emulador do Android. Para fazer isso, faça o download da imagem do sistema do emulador que inclui os serviços relacionados a jogos do Google Play, em Android 4.2.2 no SDK Manager.

Para executar o jogo no dispositivo de teste físico:

1. Verifique se você configurou a conta de teste usada para fazer login no app (como descrito na etapa 2).
2. Exporte um APK e assine-o com o mesmo certificado usado para configurar o projeto no Google Play Console. Para exportar um APK assinado no Android Studio, clique em Compilar > Gerar APK assinado.
3. Instale o APK assinado no dispositivo de teste físico usando a ferramenta adb. Para saber como instalar um app, consulte Executar em um dispositivo.

Aviso: ao executar o app diretamente no Android Studio, a ferramenta assinará o app com o certificado de depuração por padrão. Caso não tenha usado esse certificado de depuração ao configurar o app no Google Play Console, isso causará erros. Execute um APK exportado e assinado com um dos certificados usados durante a configuração do app no Google Play Console.