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

Tras la baja de la API de Google Sign-In, quitaremos el SDK de juegos de la versión 1 en 2026. Después de febrero de 2025, no podrás publicar títulos que se hayan integrado recientemente con la versión 1 del SDK de juegos en Google Play. Te recomendamos que uses la versión 2 del SDK de juegos.
Si bien los títulos existentes con las integraciones anteriores de la versión 1 de los juegos seguirán funcionando durante un par de años, te recomendamos que migres a la versión 2 a partir de junio de 2025.
Esta guía se aplica al uso del SDK de la versión 1 de los Servicios de juego de Play. El SDK de C++ para la versión 2 de los Servicios de juego de Play aún no está disponible.

En esta guía para desarrolladores, se muestra cómo compilar y ejecutar un juego en C++ en Android que usa la API de los Servicios de juego de Google Play. Antes de comenzar, descarga y configura los siguientes requisitos:

En esta guía para desarrolladores, se usa el kit de desarrollo nativo (NDK) de Android. Si no conoces el NDK, consulta la documentación y los ejemplos del NDK antes de continuar.

Paso 1: Configura tu entorno

  1. Descarga el SDK de Android y el NDK de Android, y extráelos en tu máquina. En tu entorno, configura SDK_ROOT en la ubicación de tu carpeta del SDK de Android y NDK_ROOT en la ubicación de tu carpeta del NDK de Android.
  2. Descarga los juegos de muestra de C++. En esta guía para desarrolladores, se hace referencia a la ubicación de las muestras en tu máquina como SAMPLES_DIR.
  3. Descarga el SDK de C++ de los Servicios de juego de Google Play. Extrae el SDK en tu máquina de desarrollo. En tu entorno, establece la variable NDK_MODULE_PATH para que apunte al directorio anterior al directorio gpg-cpp-sdk. Deberías tener la siguiente estructura de directorios: 
    NDK_MODULE_PATH/
gpg-cpp-sdk/
  4. Abre Eclipse. Si aún no lo hiciste, haz clic en Preferences > Android > NDK para indicarle a Eclipse dónde instalaste el NDK.

  5. Importa el proyecto de biblioteca de los Servicios de Google Play a tu espacio de trabajo de Eclipse.

    1. En Eclipse, haz clic en File > Import > Android > Existing Android Code into Workspace.
    2. Selecciona SDK_ROOT/extras/google/google_play_services/libproject/google-play-services_lib, donde SDK_ROOT es la ubicación de tu SDK de Android.
    3. Haz clic en Finish.

  6. Importa el proyecto de muestra minimalista a tu espacio de trabajo de Eclipse.

    1. En Eclipse, haz clic en File > Import > Android > Existing Android Code into Workspace.
    2. Selecciona SAMPLES_DIR/samples-android/minimalist.
    3. Haz clic en Finish.

  7. Haz clic con el botón derecho en el proyecto MinimalistActivity y, luego, en Properties. En Android, desplázate hacia abajo hasta la sección Biblioteca y asegúrate de que se haga referencia correctamente al proyecto google-play-services_lib. De lo contrario, quita la referencia y vuelve a agregarla desde tu espacio de trabajo.

Eclipse compilará automáticamente las fuentes de Java y Android de tu proyecto. Sin embargo, el código nativo de la carpeta jni debe compilarse por separado. Para hacerlo de forma manual, navega a la carpeta jni y ejecuta ndk-build. Recuerda hacerlo después de realizar cualquier cambio en la carpeta jni.

Ahora tu proyecto debería compilarse, aunque aún no funcionará. Primero debes configurar tu juego en Google Play Console.

Paso 2: Configura el juego en Google Play Console

Crea una entrada para tu juego en Google Play Console. De esta manera, se habilitarán los Servicios de juego para tu aplicación y se creará un ID de cliente de OAuth 2.0, si aún no tienes uno.

  1. Crea una entrada para tu juego siguiendo los pasos que se describen en Cómo configurar los Servicios de juego de Google Play.
  2. En AndroidManifest.xml, cambia el atributo package de la etiqueta <manifest> al nombre del paquete que elegiste cuando configuraste Google Play Console. Es posible que debas corregir algunas referencias en todo el proyecto después de realizar este cambio (en particular, en la clase R generada).
  3. Abre res/values/ids.xml y coloca el ID de tu app allí. Ten en cuenta que el ID de la app no es el mismo que el ID de cliente. Es el número que aparece junto al nombre de tu juego en la página Detalles del juego de Google Play Console.

Paso 3: Ejecuta el ejemplo

Para ejecutar la muestra, necesitarás un dispositivo Android físico o un emulador con los Servicios de Google Play instalados:

  1. Ejecuta ndk-build para compilar el código nativo.
  2. En Eclipse, haz clic en Run > Run As > Android Application y ejecuta la muestra en tu dispositivo.
  3. Cuando se abra la muestra, presiona cualquier parte de la pantalla. Deberías ver el logotipo de Google Play Juegos. Si configuraste correctamente tu app, se te pedirá que accedas a tu cuenta.

Opcional: Compila automáticamente con Eclipse

En los siguientes pasos, se muestra cómo configurar Eclipse para que ejecute ndk-build automáticamente cuando realices cambios en los archivos de la carpeta jni.

  1. Haz clic con el botón derecho en el proyecto MinimalistActivity y, luego, en Properties. En la ventana Properties, selecciona el panel Builders.
  2. Haz clic en Nuevo para agregar un nuevo compilador, selecciona Programa y, luego, haz clic en Aceptar.
  3. En el campo Name, ingresa "NDK Builder".
  4. En Ubicación, haz clic en Explorar el sistema de archivos, navega al directorio NDK_ROOT y selecciona el comando ndk-build.
  5. En Working Directory, haz clic en Browse Workspace y selecciona la carpeta del proyecto MinimalistActivity.
  6. Haz clic en la pestaña Actualizar. Asegúrate de que la casilla Actualizar recursos al completar esté marcada.
  7. Selecciona el botón de selección Recursos específicos y, luego, haz clic en Especificar recursos. En el diálogo resultante, selecciona la carpeta jni en MinimalActivity.
  8. Haz clic en Aplicar y, luego, en Aceptar para terminar de crear tu Builder.

Ahora, cada vez que edites un archivo dentro de la carpeta jni, Eclipse ejecutará ndk-build y mostrará el resultado en la consola de Eclipse.