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 dos serviços relacionados 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. Assim, você pode integre recursos populares de jogos, como conquistas, placares e Jogos salvos em jogos para tablet e dispositivos móveis.

Neste treinamento, você vai aprender a instalar um exemplo de aplicativo de jogo para Android e começar a criar rapidamente seu próprio jogo para Android. O tipo de número O aplicativo de exemplo do desafio demonstra como integrar conquistas e 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 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 seu arquivo de build do Gradle do 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 começar a criar rapidamente seu próprio jogo para Android. O tipo de número O aplicativo de exemplo do desafio demonstra como integrar conquistas e no seu jogo.

Etapa 1: fazer o download do app de exemplo

Neste guia do desenvolvedor, você precisará fazer o download do exemplo do Desafio Type-a-Number aplicativo Android.

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

1. Faça o download dos exemplos de Android no página de download de amostras.
2. Importe o projeto android-basic-samples. Este projeto inclui TypeANumber e outros jogos do Android de amostra. Para fazer isso no Android Studio:
   1. Clique em Arquivo > Importar projeto.
   2. Navegue até o diretório em que você fez o download de android-basic-samples no seu desenvolvimento. máquina virtual. 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 de pacote deve não começar com com.google, com.example ou com.android.

Etapa 2: configurar o jogo no Google Play Console

é no Google Play Console que você gerencia os serviços relacionados a jogos do Google Play para seu jogo; configurar metadados para autorizar e autenticar seu jogo.

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

1. Aponte seu navegador da Web para o Google Play Console fazer 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 adicione 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 do desenvolvedor, você pode preencher o formulário com suas próprias informações detalhes do jogo. Por conveniência, use os ícones de marcadores de posição e as capturas de tela fornecido 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 pacote exato nome usado anteriormente ao renomear o pacote de amostra.
   2. Você pode usar o assistente "Gerar APK assinado" no Android Studio para gere um novo keystore e um certificado assinado, se ainda não tiver um. Para saber como execute o assistente "Generate Signed APK", consulte Assinar o app no Android Studio.
4. Certifique-se de gravar as seguintes informações para mais tarde:
   1. O ID do seu aplicativo: é uma string consistindo apenas de dígitos (normalmente 12 ou mais) no início do seu ID de cliente.
   2. Seu certificado de assinatura: observe qual certificado você usou ao configurar seu acesso à API (o certificado cuja impressão digital SHA1 você forneceu). Você devem usar o mesmo certificado para assinar o app ao testar ou lançar a app.
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
      Humble	Solicite uma pontuação de 0.	Nenhum
      Não se exagere, garoto	Solicite uma pontuação de 9.999 em qualquer modo.	Nenhum
      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ê criados.
   4. Configure conquistas adequadas para o jogo. Para saber mais, consulte os conceitos por trás das conquistas e como implementar conquistas no Android.
6. Configure os placares de líderes 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 chamadas “Pontuações difíceis”. Os dois placares devem usar formatação de pontuação de número inteiro com zero 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 placares adequados para seu jogo. Para saber mais, veja os conceitos por trás dos 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 em 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 um 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 uma conta de teste, os serviços relacionados a jogos do Google Play se comportarão como se o jogo não existiu e você vai receber de volta ConnectionResult.SIGN_IN_REQUIRED código de retorno. Se você tentar iniciar ConnectionResult.startResolutionForResult(), você vai receber de volta 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 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ê for criar um jogo para Android do zero, será necessário criar esse arquivo primeiro.
   1. Especifique o ID do aplicativo no recurso app_id.
   2. Especifique cada ID de conquista criado anteriormente na achievement_*.
   3. Especifique cada ID de placar criado anteriormente na leaderboard_*.
2. Abra AndroidManifest.xml e insira o nome do pacote no package atributo do elemento <manifest> . Se você está criando um jogo para Android a partir de adicione o seguinte código dentro da tag <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 se você não tiver um dispositivo físico, poderá testar o Android Emulator Para isso, faça o download do imagem do sistema do emulador que inclui o Google Play Services, no Android 4.2.2, na 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 ao 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 Criação > Gerar APK assinado.
3. Instale o APK assinado no dispositivo de teste físico usando a ferramenta adb. Para saber como instalar um aplicativo, consulte Executar em um dispositivo.

.

Aviso: quando você executar o aplicativo diretamente no Android Studio, o Android Studio assinará o aplicativo com seu certificado de depuração por padrão. Se você não usou isso certificado de depuração ao configurar o aplicativo no Google Play Console, este causará erros. Execute um APK que você exportou e assinou com uma que corresponda a um dos certificados que você usou durante a inscrição. configurada no Google Play Console.