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

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

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 fácilmente funciones de juego populares, como logros, tablas de clasificación y 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 te proporcionará las herramientas para que comiences a crear tu propio juego para Android rápidamente. La app de ejemplo Type-a-Number Challenge muestra cómo puedes integrar logros y tablas de clasificación en el 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 el archivo build.gradle a nivel de proyecto, incluye el 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 los Servicios de Google Play del SDK de Play Juegos al archivo de compilación de Gradle de tu módulo, que suele ser app/build.gradle:

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

Guía de la app de muestra

En esta capacitación, se te guiará a fin de instalar una app de juego de muestra para Android y comenzar a crear tu propio juego para Android rápidamente. La app de ejemplo Type-a-Number Challenge muestra cómo puedes integrar logros y tablas de clasificación en el juego.

Paso 1: Descarga la app de muestra

En esta guía para desarrolladores, deberás descargar la aplicación de muestra para Android "Type-a-Number Challenge".

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

1. Descarga las muestras para Android de la página de descarga de muestras.
2. Importa el proyecto android-basic-samples. Este proyecto incluye TypeANumber y otras muestras de juegos para Android. Para hacerlo en Android Studio, haz lo siguiente:
   1. Haz clic en File > Import Project.
   2. Navega hasta el directorio en el que descargaste android-basic-samples en tu máquina de desarrollo. 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 uno diferente que elijas. El nuevo nombre del paquete no debe comenzar con com.google, com.example ni com.android.

Paso 2: Configura el 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 configurar el juego de muestra en Google Play Console, haz lo siguiente:

1. En el navegador web, ve a Google Play Console y accede con tu cuenta. Si todavía no te registraste en Google Play Console, se te solicitará que lo hagas.
2. Sigue estas instrucciones para agregar tu juego a Google Play Console.
   1. Cuando se te pregunte si usas las API de Google en tu app, selecciona Aún no uso ninguna API de Google en mi juego.
   2. Para los fines de esta guía para desarrolladores, puedes completar el formulario con tus propios detalles del juego. Para tu comodidad, puedes usar las capturas de pantalla y los íconos de marcador de posición que se proporcionan en la página Descargas.
3. Sigue estas instrucciones a fin de generar un ID de cliente de OAuth 2.0 para tu app para Android.
   1. Cuando vincules tu app para Android, asegúrate de especificar el nombre de 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 a fin de generar un almacén de claves y certificados firmados nuevos, si todavía no los tienes. Para obtener información sobre cómo ejecutar el Asistente para generar un APK firmado, consulta Cómo firmar una app en Android Studio.
4. Asegúrate de registrar la siguiente información para más tarde:
   1. Tu ID de aplicación: Se trata de un string que contiene únicamente dígitos (en general, 12 o más) al comienzo del ID de cliente.
   2. Tu certificado de firma: Anota el certificado que usaste cuando configuraste tu acceso a la API (el certificado cuya huella digital SHA1 proporcionaste). Debes usar el mismo certificado para firmar la app cuando la pruebes o lances.
5. Configura logros para Type-a-Number Challenge:
   1. Selecciona la pestaña Logros en Google Play Console.
   2. Agrega los siguientes logros de muestra:

      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 engañes, niño	Solicita una puntuación de 9,999 en cualquier modo.	Ninguno
      ¡SOS EL MEJOR!	Recibe una puntuación 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 desbloquearlo.
      Muy, muy aburrido	Juega el juego 100 veces.	Haz que este sea un logro incremental con 100 pasos para conseguirlo.

   3. Registra los ID (strings alfanuméricas extensas) para cada uno de los logros que creaste.
   4. Configura logros 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 "Puntuaciones altas fáciles" y la otra, "Puntuaciones altas difíciles". Ambas tablas deben usar el formato de puntuación entera sin lugares decimales y un tipo de organización A mayor puntaje, mejor.
   3. Registra los ID (strings alfanuméricas extensas) para cada una de las tablas de clasificación que creaste.
   4. Configura tablas de clasificación que sean adecuadas 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 que se publique la app, solo pueden acceder a ella las cuentas de prueba que se incluyan en Google Play Console. Sin embargo, una vez que se publica una aplicación, todos pueden acceder.

Advertencia: Si intentas realizar llamadas al SDK de Play Juegos para un juego no publicado mediante una cuenta que no aparece como cuenta de prueba, los Servicios de juego de Google Play se comportarán como si el juego no existiera y recibirás el código de retorno ConnectionResult.SIGN_IN_REQUIRED. Si intentas iniciar ConnectionResult.startResolutionForResult(), obtendrás 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 el 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 ID de marcador de posición. Si estás creando un juego para Android desde cero, primero deberás crear este archivo.
   1. Especifica tu ID de aplicación en el recurso app_id.
   2. Especifica cada ID de logro que creaste antes en el recurso achievement_* correspondiente.
   3. Especifica cada ID de tabla de clasificación que creaste antes en el recurso leaderboard_* correspondiente.
2. Abre AndroidManifest.xml y, luego, ingresa el nombre de tu paquete en el atributo package del elemento <manifest>. Si estás creando un juego para Android desde cero, asegúrate de agregar también el siguiente código dentro del 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"/>
   

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 no tienes un dispositivo físico, puedes realizar la prueba en el Android Emulator. Para ello, descarga la imagen del sistema del emulador que incluye los Servicios de Google Play, en Android 4.2.2, desde SDK Manager.

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

1. Verifica que hayas configurado la cuenta de prueba que usarás 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 para configurar el proyecto en Google Play Console. Para exportar un APK firmado en Android Studio, haz clic en Build > Generate Signed APK.
3. Instala el APK firmado en el dispositivo de prueba físico mediante la herramienta adb. Para obtener más 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, este firmará la aplicación con el certificado de depuración de forma predeterminada. Si no usaste este certificado de depuración cuando configuraste la aplicación en Google Play Console, se generarán errores. Asegúrate de ejecutar un APK que hayas exportado y firmado con un certificado que coincida con uno de los que usaste durante la configuración de la aplicación en Google Play Console.