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

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 reconocidas de los juegos, como logros, tablas de clasificación, juegos guardados y multijugador en tiempo real (en Android) en tus juegos para tablets y 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 de inmediato. La app de ejemplo "Type-a-Number Challenge" te muestra cómo puedes integrar logros y tablas de clasificación en tu juego.

Antes de comenzar

  • Configura tu entorno de desarrollo para Android. Si eres nuevo en el desarrollo de aplicaciones para Android, consulta Cómo crear tu primera app.
  • Debes tener disponible un dispositivo con Android 4.0 (Ice Cream Sandwich) o versiones posteriores para realizar las pruebas.

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 muestra en Android Studio, sigue estos pasos:

  1. Descarga las muestras de Android de esta página.
  2. Importa el proyecto android-basic-samples. Este proyecto incluye TypeANumber y otras muestras de juegos para Android. Para hacer esto en Android Studio:
    1. Haz clic en File > Import Project.
    2. En tu máquina de desarrollo, busca el directorio en el que descargaste android-basic-samples. Selecciona el archivo android-basic-samples/build.gradle y haz clic en OK.
  3. En el módulo TypeANumber, abre AndroidManifest.xml y cambia el nombre de paquete de com.google.example.games.tanc a otro 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 pedirá que lo hagas.
  2. Sigue las 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 utilizo las API de Google en mi juego.
    2. A los fines de esta guía para desarrolladores, puedes llenar el formulario con los detalles de tu juego. Para una mayor practicidad, puedes usar los íconos de marcadores de posición y las capturas de pantalla que se proporcionan en la página Descargas.
  3. Sigue las instrucciones para generar un ID de cliente de OAuth 2.0 destinado a tu app para Android.
    1. Cuando vincules tu app para Android, asegúrate de especificar el nombre de paquete exacto que usaste antes cuando cambiaste el nombre del paquete de muestra.
    2. Puedes usar el asistente para generar APK firmados en Android Studio con el fin de crear un nuevo almacén de claves y un certificado firmado, si aún no los tienes. Si quieres obtener información acerca de cómo ejecutar el asistente para generar APK firmados, consulta la sección sobre firma de apps en Android Studio.
  4. Asegúrate de tomar nota de estos datos para usarlos más adelante:
    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 cuál certificado usaste cuando configuraste el acceso a la API (el certificado del que proporcionaste la huella digital SHA1). Debes usar el mismo certificado para firmar la app cuando la publiques o pruebes.
  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
      Primo Obtén una puntuación que sea un número primo. Ninguna
      Simple Solicita una puntuación de 0. Ninguna
      No te agrandes Solicita una puntuación de 9,999 en cualquier modo. Ninguna
      ¡ERES 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 conseguirlo.
      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éricos extensos) de cada uno de los logros que hayas creado.
    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 "Puntuaciones altas fáciles" y la otra, "Puntuaciones altas difíciles". Ambas tablas de clasificación 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éricos extensos) de cada una de las tablas de clasificación que hayas creado.
    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 es necesario únicamente para las apps que todavía no se hayan publicado 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 publique, todos tendrán acceso.

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 archivo 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 generar este archivo.
    1. Especifica tu ID de aplicación en el recurso app_id.
    2. En el recurso achievement_* correspondiente, especifica cada ID de logro que hayas creado.
    3. En el recurso leaderboard_* correspondiente, especifica cada ID de tabla de clasificación que hayas creado.
  2. Abre AndroidManifest.xml y agrega el nombre del 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.

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

  1. Verifica si configuraste 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. Si quieres obtener información para instalar una aplicación, consulta la sección sobre cómo ejecutar una app en un dispositivo.