Esta página foi traduzida pela API Cloud Translation.

Introdução aos 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 e jogos salvos para tablets 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

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 do projeto, inclua o repositório Maven do Google e o repositório central do Maven 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 exemplo de app

Este treinamento orienta você durante a instalação de um exemplo de app de jogo para Android e oferece 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.

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:

Faça o download dos exemplos para Android na página de download de exemplos.
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.
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

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:

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.
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.
Siga estas instruções para gerar um ID de cliente do 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. 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.
Anote 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. 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.

Configure conquistas para Type-a-Number Challenge:

Selecione a guia Conquistas no Google Play Console.

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.

Registre os códigos (strings alfanuméricas longas) de cada conquista criada.
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.

Configure os placares de líderes para o Type-a-Number Challenge:
1. Selecione a guia de Placares no Google Play Console.
2. Adicione dois exemplos de placares de líderes: 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 um tipo de ordenação Maior é melhor.
3. Registre os IDs (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.
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.

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 no AndroidManifest.xml.

Abra res/values/ids.xml e substitua os IDs de marcador de posição. 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 IDs de conquistas criados anteriormente no recurso achievement_* correspondente.
3. Especifique todos os IDs de placar de líderes criados anteriormente no recurso leaderboard_* correspondente.

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.

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

Verifique se você configurou a conta de teste usada para fazer login no app (como descrito na etapa 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.
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.