Tablas de clasificación en el juego de Android

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:

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.