Introdução aos serviços relacionados a jogos do Google Play para Android

Atenção : este guia destina-se ao uso do SDK dos serviços relacionados a jogos do Google Play v1. Para informações sobre o SDK mais recente, consulte a documentação do serviço relacionado a jogos do Google Play v2.

Este é o desenvolvimento de jogos para Android com os serviços relacionados a jogos do Google Play.

O SDK do Play Games oferece serviços relacionados a jogos do Google Play em várias plataformas que permitem integrar facilmente recursos conhecidos de jogos, como conquistas, placares e jogos salvos em jogos para tablet e dispositivos móveis.

Neste treinamento, você vai instalar um app de jogo de exemplo para Android e aprender a criar seu próprio jogo Android rapidamente. O app de exemplo Type-a-Number Challenge demonstra como integrar conquistas e placares ao seu jogo.

Antes de começar

Para preparar o app, siga as etapas nas seções a seguir.

Pré-requisitos do app

O arquivo de build do app precisa usar estes valores:

• A minSdkVersion precisa ser definida como 19 ou versões mais recentes.
• A compileSdkVersion precisa ser definida como 28 ou versões mais recentes.

Configurar seu 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 mais informações, consulte Como configurar os serviços relacionados a jogos do Google Play.

Configurar o app

No arquivo build.gradle no nível do projeto, inclua o repositório Maven do Google e o repositório Maven central (links em inglês) nas seções buildscript e allprojects:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

Adicione a dependência do Google Play Services para o SDK do Play Games ao arquivo de build do Gradle do seu módulo, que geralmente é app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

Guia de aplicativo de exemplo

Neste treinamento, você vai aprender a instalar um app de jogo de exemplo para Android e aprender a criar seu próprio jogo para Android rapidamente. O app de exemplo Type-a-Number Challenge demonstra como integrar conquistas e placares ao seu jogo.

Etapa 1: fazer o download do app de exemplo

Neste guia do desenvolvedor, você precisará fazer o download do aplicativo 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 File > Import Project.
   2. Navegue até o diretório em que 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 mude 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 ou com.android.

Etapa 2: configurar o jogo no Google Play Console

O Google Play Console é onde você gerencia os serviços relacionados a jogos do Google Play e configura metadados para autorizar e autenticar seu jogo.

Para configurar o jogo de amostra no Google Play Console, faça o seguinte:

1. Acesse o Google Play Console no navegador da Web e faça login. Caso você ainda não tenha se registrado no Google Play Console, receberá uma solicitação para fazer isso.
2. Siga estas instruções para adicionar seu jogo ao Google Play Console.
   1. Quando aparecer a mensagem perguntando se você usa APIs do Google no app, selecione Ainda não uso APIs do Google no meu jogo.
   2. Neste guia para desenvolvedores, você pode preencher o formulário com os detalhes do seu jogo. Por conveniência, você pode usar os ícones de marcador de posição e as capturas de tela fornecidos na página Downloads.
3. Siga estas instruções para gerar um ID do cliente OAuth 2.0 para seu app Android.
   1. Ao vincular seu app Android, especifique o nome exato do pacote usado anteriormente ao renomear o pacote de exemplo.
   2. Use o assistente "Gerar APK assinado" no Android Studio para gerar um novo keystore e um certificado assinado, caso ainda não tenha feito isso. Para saber como executar o assistente "Gerar APK assinado", consulte Assinar seu app no Android Studio.
4. Registre as seguintes informações para mais tarde:
   1. ID do aplicativo: é uma string que consiste apenas em dígitos (normalmente 12 ou mais) no início do seu ID do cliente.
   2. Seu certificado de assinatura: anote o certificado usado ao configurar seu acesso à API (o certificado cuja impressão digital SHA1 você forneceu). Use 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
      Plica	Consiga uma pontuação que seja um número primo.	Nenhum controle
      Humble	Solicite uma pontuação de 0.	Nenhum controle
      Não se exagere, garoto	Solicite uma pontuação de 9.999 em qualquer modo.	Nenhum controle
      UBER TÉM UBER LEET!	Recebe uma pontuação de 1.337.	Torne essa conquista oculta.
      Entediado	Jogue 10 vezes.	Torne essa uma conquista incremental com 10 passos para desbloquear.
      Muito entediado	Jogue 100 vezes.	Torne essa uma conquista incremental com 100 passos para desbloquear.

   3. Registre os IDs (strings alfanuméricas longas) para cada conquista que você criou.
   4. Configure conquistas adequadas para o jogo. Para saber mais, consulte os conceitos por trás de conquistas e como implementar conquistas no Android.
6. Configure os placares do Type-a-Number Challenge:
   1. Selecione a guia 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 precisam 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 IDs (strings alfanuméricas longas) para cada placar de líderes que criou.
   4. Configure placares adequados para 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 do app, apenas as contas de teste listadas no Google Play Console podem fazer login. No entanto, depois que o aplicativo é 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 como de teste, os serviços relacionados a jogos do Google Play vão se comportar como se o jogo não existisse, e você vai receber o código de retorno ConnectionResult.SIGN_IN_REQUIRED. Se você tentar iniciar ConnectionResult.startResolutionForResult(), vai receber GamesActivityResultCodes.RESULT_SIGN_IN_FAILED.

Etapa 3: modificar seu código

Para executar o jogo, você precisa configurar o ID do aplicativo como um recurso no projeto do Android. Também vai ser necessário adicionar os metadados do jogo no AndroidManifest.xml.

1. Abra res/values/ids.xml e substitua os IDs de marcador. Se você está criando um jogo para Android do zero, é necessário gerar esse arquivo primeiro.
   1. Especifique o ID do aplicativo no recurso app_id.
   2. Especifique cada ID de conquista criado anteriormente no recurso achievement_* correspondente.
   3. Especifique cada ID de placar criado 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 zero, 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 garantir que os serviços relacionados a jogos do Google Play estejam funcionando corretamente no jogo, teste o app antes de publicá-lo no Google Play.

Observação: recomendamos testar em um dispositivo Android físico. No entanto, se você não tiver um dispositivo físico, poderá testar no Android Emulator. Para isso, faça o download da imagem do sistema do emulador que inclui o Google Play Services, em Android 4.2.2, no SDK Manager.

Para executar o jogo no dispositivo de teste físico, faça o seguinte:

1. Verifique se você configurou a conta de teste que está usando para fazer login no app, conforme 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 Build > Generate Signed APK.
3. Instale o APK assinado no dispositivo de teste físico usando a ferramenta adb. Para aprender a instalar um aplicativo, consulte Executar em um dispositivo.

Aviso: quando você executa o app diretamente no Android Studio, ele assina o app com o certificado de depuração por padrão. Se você não usou esse certificado de depuração ao configurar o app no Google Play Console, isso causará erros. Execute um APK que você exportou e assinou com um certificado que corresponda a um dos certificados usados durante a configuração do app no Google Play Console.