En esta guía, se muestra cómo usar las APIs de logros en una aplicación para Android para desbloquear y mostrar logros en el juego. Se pueden encontrar las APIs 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 logros en los juegos.
Antes de comenzar a programar con la API de logros, haz lo siguiente:
- Sigue las instrucciones para instalar y configurar tu app para usar los Servicios de juego de Google Play en la guía Cómo configurar el SDK de los Servicios de Google Play.
- Define los logros que quieres que el juego desbloquee o muestre siguiendo las instrucciones de la guía de Google Play Console.
- Descarga y revisa las muestras de código de logros en la página de ejemplos de Android.
- Familiarízate con las recomendaciones que se describen en la lista de tareas de calidad.
Cómo obtener un cliente de logros
Para 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 y el GoogleSignInAccount del reproductor actual. Si quieres saber cómo recuperar la información de la cuenta del jugador, consulta Información sobre el acceso a juegos para Android.
Cómo desbloquear los logros
Para 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:
Games.getAchievementsClient(this, GoogleSignIn.getLastSignedInAccount(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 logro del jugador:
Games.getAchievementsClient(this, GoogleSignIn.getLastSignedInAccount(this))
.increment(getString(R.string.my_achievement_id), 1);No es necesario que escribas código adicional para 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 para evitar exceder tu cuota de API.
Cómo mostrar los logros
Para mostrar los logros de un jugador, llama a AchievementsClient.getAchievementsIntent() para 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() { Games.getAchievementsClient(this, GoogleSignIn.getLastSignedInAccount(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.
