En esta guía, se muestra cómo usar las API de tablas de clasificación en una aplicación para Android a fin de crear tablas de clasificación visuales, registrar la puntuación de un jugador y compararla con la del jugador de sesiones anteriores. Se pueden encontrar las API en los paquetes com.google.android.gms.games y com.google.android.gms.games.leaderboards.
Antes de comenzar
Si aún no lo hiciste, puede resultarte útil revisar los conceptos de juegos de tablas de clasificación.
Antes de comenzar a programar mediante las API de tablas de clasificación, haz lo siguiente:
- Sigue las instrucciones para instalar y configurar tu app a fin de usar los Servicios de juego de Google Play en la guía Cómo configurar el SDK de los Servicios de Google Play.
- Define las tablas de clasificación que quieres que el juego muestre o actualice. Para ello, sigue las instrucciones de la guía de Google Play Console.
- Descarga y revisa las muestras de código de tablas de clasificación en la página de muestras de Android.
- Familiarízate con las recomendaciones que se describen en la lista de tareas de calidad.
Obtén el cliente de tablas de clasificación
A fin de comenzar a usar la API de tablas de clasificación, el juego primero debe obtener un objeto LeaderboardsClient.
Para ello, llama al método Games.getLeadeboardsClient() y pasa la actividad.
Cómo actualizar la puntuación del jugador
Cuando la puntuación del jugador cambia (por ejemplo, al terminar el juego), el juego puede actualizar la puntuación en la tabla de clasificación llamando a LeaderboardsClient.submitScore() y pasando el ID de la tabla de clasificación y el valor de la puntuación sin procesar.
En el siguiente fragmento de código, se muestra cómo la app puede actualizar la puntuación del jugador:
PlayGames.getLeaderboardsClient(this)
.submitScore(getString(R.string.leaderboard_id), 1337);
Una práctica recomendada consiste en definir el ID de la tabla de clasificación en el archivo strings.xml, de modo que el juego pueda hacer referencia a las tablas de clasificación por ID de recurso. Cuando realices llamadas para actualizar y cargar puntuaciones de jugadores, asegúrate de seguir también estas prácticas recomendadas a fin de evitar exceder tu cuota de API.
Cómo mostrar una tabla de clasificación
Si deseas mostrar la tabla de clasificación, llama a LeaderboardsClient.getLeaderboardIntent() a fin de obtener un Intent y crear la interfaz de usuario de la tabla de clasificación 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 actualizar la puntuación del jugador. En este fragmento, RC_LEADERBOARD_UI es un número entero arbitrario para el código de solicitud.
private static final int RC_LEADERBOARD_UI = 9004;
private void showLeaderboard() {
PlayGames.getLeaderboardsClient(this)
.getLeaderboardIntent(getString(R.string.leaderboard_id))
.addOnSuccessListener(new OnSuccessListener<Intent>() {
@Override
public void onSuccess(Intent intent) {
startActivityForResult(intent, RC_LEADERBOARD_UI);
}
});
}
Ten en cuenta que, aunque no se muestre ningún resultado, debemos usar startActivityForResult para que la API pueda obtener la identidad del paquete que realiza la llamada. A continuación, se muestra un ejemplo de la IU predeterminada de tablas de clasificación.
