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

Conheça 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 de jogos conhecidos, como conquistas, placares e jogos salvos nos seus jogos para tablet e dispositivos móveis.

Este treinamento orientará você a instalar um aplicativo de jogo de amostra para Android e a criar rapidamente seu próprio jogo para Android. 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 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.1.0'
  }

Guia do app de exemplo

Este treinamento orientará você a instalar um app de jogo de exemplo para Android e a criar rapidamente o seu próprio jogo para Android. 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

Para este 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 para onde você fez o download de android-basic-samples na 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 de pacote 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

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 exemplo no Google Play Console, faça o seguinte:

  1. Acesse o Google Play Console no navegador e faça login. Caso ainda não tenha se registrado no Google Play Console, você vai 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 seu app, selecione Ainda não utilizo APIs do Google no meu jogo.
    2. Neste guia para desenvolvedores, você pode preencher o formulário com os detalhes do seu próprio 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 do OAuth 2.0 para seu app Android.
    1. Ao vincular seu app Android, especifique o nome exato do pacote que você usou anteriormente ao renomear o pacote de exemplo.
    2. Você pode usar o assistente "Gerar APK assinado" no Android Studio para gerar um novo keystore e um certificado assinado, se ainda não tiver um. 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: essa é uma string que contém apenas dígitos (normalmente 12 ou mais) no início do seu ID do cliente.
    2. Certificado de assinatura: anote o certificado usado ao configurar o acesso à API (o certificado cuja impressão digital SHA1 você forneceu). Use o mesmo certificado para assinar o app ao testar ou lançar o app.
  5. Configure conquistas para o 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
      Premium Recebe uma pontuação que é um número primo. Nenhuma
      Humble Solicite uma pontuação de 0. Nenhuma
      Não fique se achando Solicite uma pontuação de 9999 em qualquer modo. Nenhuma
      VAMOS AO QUE INTERESSA! Receba uma pontuação de 1.337. Faça com que essa conquista seja oculta.
      Tédio Jogue 10 vezes. Faça com que essa seja uma conquista incremental com 10 etapas a serem desbloqueadas.
      Muito entediado Jogue 100 vezes. Faça desta uma conquista incremental com 100 passos para desbloquear.
    3. Registre os IDs (strings alfanuméricas longas) de cada conquista criada.
    4. Configure conquistas adequadas para seu jogo. Para saber mais, consulte os conceitos por trás de conquistas e como implementar conquistas no Android.
  6. Configure os rankings para o desafio Type-a-Number:
    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 um tipo de ordenação Maior é melhor.
    3. Registre os IDs (strings alfanuméricas longas) para cada quadro de liderança criado.
    4. Configure os rankings apropriados 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 apenas para apps que ainda não foram publicados no Google Play Console. Antes da publicação do app, somente as contas de teste listadas no Google Play Console podem fazer login. No entanto, depois que o aplicativo é publicado, todos podem fazer login.

Etapa 3: modificar seu código

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

  1. Abra res/values/ids.xml e substitua os IDs dos marcadores. Se você estiver criando um jogo para Android do zero, precisará criar 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 aplicativo antes de publicá-lo no Google Play.

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

  1. Verifique se você configurou a conta de teste usada 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 app, consulte Executar em um dispositivo.