En esta guía, se muestra cómo usar las APIs de tablas de clasificación en una aplicación para Android
para crear tablas de clasificación visuales, registrar la puntuación de un jugador y compararla
con respecto a la puntuación
del jugador en sesiones anteriores. Se pueden encontrar las APIs 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 de instalación y configuración de tu app para su uso Los Servicios de juego de Google Play Guía para configurar el SDK de los Servicios de Google Play.
- Define las tablas de clasificación que deseas que muestre o actualice el juego. siguiendo las instrucciones de la guía de Google Play Console
- Descarga y revisa los ejemplos de código de las tablas de clasificación en el Página de muestras de Android.
- Familiarízate con las recomendaciones que se describen en la lista de tareas de calidad.
Cómo obtener 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 el
y GoogleSignInAccount del jugador actual. Para aprender a recuperar el
la información de la cuenta del jugador, consulta Acceso a juegos para Android.
Cómo actualizar la puntuación del jugador
Cuando la puntuación del jugador cambia (por ejemplo, cuando se termina 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:
Games.getLeaderboardsClient(this, GoogleSignIn.getLastSignedInAccount(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. Al hacer llamadas a
actualizar y cargar las puntuaciones de los jugadores, asegúrate de seguir
prácticas recomendadas para 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() para 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() {
Games.getLeaderboardsClient(this, GoogleSignIn.getLastSignedInAccount(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 devuelve 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.
