Cómo comenzar a usar los Servicios de juego de Play para Android

Precaución: Esta guía se aplica a los Servicios de juego de Play v1 SDK. Para información sobre el SDK más reciente, consulta la documentación de la versión 2 del Servicio de juego de Play.

Te damos la bienvenida al desarrollo de juegos para Android con los servicios de juego de Google Play.

El SDK de Play Juegos proporciona servicios de juego de Google Play multiplataforma que te permiten integrar funciones populares de juego, como logros, tablas de clasificación, Juegos guardados en tu tablet y juegos para dispositivos móviles.

Esta capacitación te guiará en la instalación de un ejemplo de aplicación de juego para Android y comienza rápidamente a crear tu propio juego para Android. El tipo de número La aplicación de ejemplo de desafío demuestra cómo puedes integrar logros y tablas de clasificación en tu juego.

Antes de comenzar

Para preparar tu app, completa los pasos que se indican en las siguientes secciones.

Requisitos previos de la app

Asegúrate de que el archivo de compilación de tu app use los siguientes valores:

• Una minSdkVersion de 19 o más
• Una compileSdkVersion de 28 o más

Cómo configurar tu juego en Google Play Console

Google Play Console es el entorno donde administras los servicios de juego de Google Play y configuras metadatos para autorizar y autenticar tu juego. Para obtener más información, consulta Cómo configurar los Servicios de juego de Google Play.

Cómo configurar tu app

En tu archivo build.gradle de nivel de proyecto, incluye Repositorio Maven de Google y el repositorio central de Maven. en las secciones buildscript y allprojects:

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

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

Agrega la dependencia de Servicios de Google Play para el SDK de Play Juegos a tu archivo de compilación de Gradle del módulo, que se suele app/build.gradle:

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

Guía de apps de ejemplo

Esta capacitación te guiará en la instalación de una app de juego de muestra para Android y comienza rápidamente a crear tu propio juego para Android. El tipo de número La aplicación de ejemplo de desafío demuestra cómo puedes integrar logros y tablas de clasificación en tu juego.

Paso 1: Descarga la app de ejemplo

Para esta guía del desarrollador, deberás descargar la muestra del desafío Type-a-Number. aplicación para Android.

Para descargar y configurar la aplicación de ejemplo en Android Studio, haz lo siguiente:

1. Descarga los ejemplos de Android del página de descarga de muestras.
2. Importa el proyecto android-basic-samples. Este proyecto incluye TypeANumber y otros juegos para Android de muestra. Para hacer esto en Android Studio:
   1. Haz clic en Archivo > Importa el proyecto.
   2. Navega hasta el directorio en el que descargaste android-basic-samples del desarrollo. máquina. Selecciona el archivo android-basic-samples/build.gradle y haz clic en Aceptar.
3. En el módulo TypeANumber, abre AndroidManifest.xml y cambia el nombre del paquete de com.google.example.games.tanc a un nombre de paquete diferente. El nuevo nombre del paquete debe no comienza con com.google, com.example ni com.android.

Paso 2: Configura el juego en Google Play Console

Google Play Console es el lugar donde administras los Servicios de juego de Google Play para tu juego. configurar los metadatos para autorizar y autenticar tu juego

Para configurar el juego de muestra en Google Play Console, haz lo siguiente:

1. Dirige tu navegador web a la Google Play Console accede a tu cuenta. Si todavía no te registraste en Google Play Console, se te solicitará que lo hagas.
2. Sigue estas instrucciones para agrega tu juego a Google Play Console.
   1. Cuando se te pregunte si usas las APIs de Google en tu app, selecciona Aún no uso ninguna API de Google en mi juego.
   2. A los efectos de esta guía para desarrolladores, puedes completar el formulario con tus los detalles del juego. Para mayor comodidad, puedes usar los íconos de marcador de posición y las capturas de pantalla que se proporciona en la página Descargas.
3. Sigue estas instrucciones para generar un ID de cliente de OAuth 2.0 para tu app de Android.
   1. Cuando vincules tu app para Android, asegúrate de especificar el paquete exacto que usaste anteriormente cuando cambiaste el nombre del paquete de muestra.
   2. Puedes usar el asistente para generar APK firmados en Android Studio genera un nuevo almacén de claves y un certificado firmado si aún no tienes uno. Para aprender a hacer lo siguiente: ejecuta el asistente para generar APK firmados, consulta Cómo firmar tu app en Android Studio
4. Asegúrate de registrar la siguiente información para más adelante:
   1. El ID de aplicación: Es una cadena consta de solo dígitos (por lo general, 12 o más) al comienzo de tu ID de cliente.
   2. Tu certificado de firma: Anota qué certificado usaste durante la configuración tu acceso a la API (el certificado para el que proporcionaste la huella digital SHA1). Tú debes usar el mismo certificado para firmar la app cuando pruebes o lances tu .
5. Configura logros para Type-a-Number Challenge:
   1. Selecciona la pestaña Logros en Google Play Console.
   2. Agrega los siguientes logros de ejemplo:

      Nombre	Descripción	Instrucciones especiales
      Prime	Obtén una puntuación que sea un número primo.	Ninguno
      Humilde	Solicita una puntuación de 0.	Ninguno
      No te pongas arrogante, niño	Solicita una puntuación de 9,999 en cualquier modo.	Ninguno
      ¡Increíble!	Recibe un puntaje de 1,337.	Haz que este sea un logro oculto.
      Aburrido	Juega el juego 10 veces.	Haz que este sea un logro incremental con 10 pasos para conseguirlo.
      Muy, muy aburrido	Juega el juego 100 veces.	Haz de este un logro incremental con 100 pasos para conseguirlo.

   3. Registra los IDs (cadenas alfanuméricas extensas) de cada logro que hayas crear.
   4. Configura logros que sean adecuados para tu juego. Para obtener más información, Consulta los conceptos detrás de los logros. y cómo implementar logros en Android.
6. Configura las tablas de clasificación para Type-a-Number Challenge:
   1. Selecciona la pestaña Tablas de clasificación en Google Play Console.
   2. Agrega dos tablas de clasificación de muestra: una denominada "Puntajes altos fáciles" y otra. llamada “Puntuaciones altas difíciles”. Ambas tablas de clasificación deben usar el formato de puntuación de número entero. con 0 decimales y un tipo de orden A mayor puntaje, mejor.
   3. Registra los ID (cadenas alfanuméricas extensas) de cada tabla de clasificación que hayas creado.
   4. Configura tablas de clasificación que sean apropiadas para tu juego. Para obtener más información, consulta los conceptos detrás de las tablas de clasificación y cómo implementar tablas de clasificación en Android.
7. Agrega cuentas de prueba para tu juego. Este paso solo es necesario para las apps que aún no se publicaron en Google Play Console. Antes de publicar la app, solo se muestran las cuentas de prueba de Google Play Console. Sin embargo, una vez que se publica la aplicación, todos pueden acceder.

Advertencia: Si intentas realizar llamadas al SDK de Play Juegos para un juego no publicado usando una cuenta que no figura como cuenta de prueba, los servicios de juego de Google Play Si el juego no existiera, y recibirás ConnectionResult.SIGN_IN_REQUIRED el código de retorno. Si intentas iniciar ConnectionResult.startResolutionForResult(), te devolveremos GamesActivityResultCodes.RESULT_SIGN_IN_FAILED

Paso 3: Modifica tu código

Para ejecutar el juego, debes configurar el ID de aplicación como un recurso en tu Proyecto de Android. También deberás agregar metadatos de los juegos en el AndroidManifest.xml.

1. Abre res/values/ids.xml y reemplaza los IDs de marcador de posición. Si eres si creas un juego para Android desde cero, primero deberás crear este archivo.
   1. Especifica el ID de tu aplicación en el recurso app_id.
   2. Especifica cada ID de logro que hayas creado anteriormente en la ruta de achievement_* recurso.
   3. Especifica cada ID de la tabla de clasificación que creaste antes en el archivo leaderboard_* recurso.
2. Abre AndroidManifest.xml e ingresa el nombre del paquete en el archivo package de la <manifest> . Si estás creando un juego para Android desde desde cero, asegúrate de agregar también el siguiente código dentro de la etiqueta <application> elemento:

   <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"/>
   

Paso 4: Prueba tu juego

Para asegurarte de que los Servicios de juego de Google Play funcionen correctamente en tu juego, prueba la aplicación antes de publicarla en Google Play.

Nota: Se recomienda que realices la prueba en un dispositivo Android físico. Sin embargo, si pero no tienes un dispositivo físico, puedes hacer pruebas Android Emulator Para ello, descarga el de Android y el emulador que incluye la Servicios de Google Play, en Android 4.2.2, de la SDK Manager.

Para ejecutar el juego en tu dispositivo de prueba físico, haz lo siguiente:

1. Verifica si configuraste la cuenta de prueba que usas para acceder a la app (como se describe en el Paso 2).
2. Exporta un APK y fírmalo con el mismo certificado que usaste durante la configuración el proyecto en Google Play Console. Para exportar un APK firmado en Android Studio, haz clic en Compilación > Generar APK firmado:
3. Instala el APK firmado en el dispositivo de prueba físico con la herramienta adb. Para obtener información sobre cómo instalar una aplicación, consulta Ejecución en un dispositivo.

Advertencia: Cuando ejecutes la aplicación directamente desde Android Studio, Android Studio firmará a la aplicación con tu certificado de depuración de forma predeterminada. Si no usaste esta certificado de depuración cuando configures la app en Google Play Console, causará errores. Asegúrate de ejecutar un APK que hayas exportado y firmado con una certificado que coincida con uno de los que usaste durante la postulación configuración en Google Play Console.