Logros de juegos para Android

En esta guía, se muestra cómo usar las API de logros en una aplicación para Android a fin de desbloquear y mostrar logros en el juego. Se pueden encontrar las API en los paquetes com.google.android.gms.games y com.google.android.gms.games.achievements.

Antes de comenzar

Si aún no lo hiciste, puede resultarte útil consultar los conceptos de juegos de logros.

Antes de comenzar a programar con la API de logros, haz lo siguiente:

Cómo obtener un cliente de logros

A fin de comenzar a usar la API de logros, primero el juego debe obtener un objeto AchievementsClient. Para ello, llama al método Games.getAchievementClient() y pasa la actividad.

Cómo desbloquear los logros

Si deseas desbloquear un logro, llama al método AchievementsClient.unlock() y pasa el ID del logro.

En el siguiente fragmento de código, se muestra cómo tu app puede desbloquear logros:

PlayGames.getAchievementsClient(this).unlock(getString(R.string.my_achievement_id));

Si el logro es de tipo incremental (es decir, se requieren varios pasos para desbloquearlo), llama a AchievementsClient.increment() en su lugar.

En el siguiente fragmento de código, se muestra cómo la app puede aumentar el rendimiento del jugador:

PlayGames.getAchievementsClient(this).increment(getString(R.string.my_achievement_id), 1);

No es necesario que escribas código adicional a fin de desbloquear el logro. Los Servicios de juego de Google Play lo desbloquearán automáticamente cuando se alcance la cantidad de pasos necesarios.

Una práctica recomendada consiste en definir el ID de los logros en el archivo strings.xml, de modo que el juego pueda hacer referencia a los logros por ID de recurso. Cuando realices llamadas para actualizar y cargar logros, asegúrate de seguir también estas prácticas recomendadas a fin de evitar exceder tu cuota de API.

Cómo mostrar los logros

Si deseas mostrar los logros de un jugador, llama a AchievementsClient.getAchievementsIntent() a los efectos de obtener un Intent y crear la interfaz de usuario de logros predeterminada. Para que pueda abrir la IU, el juego podrá llamar a startActivityForResult.

En el siguiente fragmento de código, se muestra cómo la app puede mostrar la interfaz de usuario predeterminada de logros. En el fragmento, RC_ACHIEVEMENT_UI es un número entero arbitrario que el juego utiliza como código de solicitud.

private static final int RC_ACHIEVEMENT_UI = 9003;

private void showAchievements() {
  PlayGames.getAchievementsClient(this)
      .getAchievementsIntent()
      .addOnSuccessListener(new OnSuccessListener<Intent>() {
        @Override
        public void onSuccess(Intent intent) {
          startActivityForResult(intent, RC_ACHIEVEMENT_UI);
        }
      });
}

A continuación, se muestra un ejemplo de la IU predeterminada de logros.