Google Play Game Services: Tablas de clasificación

Spanish (Español) translation by CYC (you can also view the original English article)

Los servicios de juegos de Google Play brindan la oportunidad de agregar funciones sociales a tus juegos a través de las cuentas de Google+ de los usuarios. En este tutorial, demostraremos cómo puedes agregar tablas de clasificación a una aplicación Android, presentar puntajes de usuarios y presentar las clasificaciones actuales de los usuarios dentro del juego.

El uso de tablas de clasificación implica preparar tu IDE, configurar la tabla de líderes en Google Play Developer Console y agregar funcionalidad a tu aplicación.

Si completaste el reciente tutorial sobre cómo agregar logros a las aplicaciones Android, podrás omitir algunos de los pasos en este. El código fuente adjunto incluye la misma aplicación que utilizamos para el tutorial de logros, con los logros y la funcionalidad de tablas de clasificación añadidas.

1. Prepara tu IDE

Paso 1

Para usar Google Play Services, necesitas ciertas utilidades instaladas en tu entorno de desarrollo. Además, dado que estamos usando Game Services, instalaremos la biblioteca BaseGameUtils, que reduce la cantidad de codificación que necesitamos para implementar funciones como el inicio de sesión de Google+.

Para comenzar, crea una nueva aplicación o usa una existente. Si seguiste el tutorial de logros, puedes usar la aplicación que creaste para ese tutorial. Si estás creando tu propio juego, decide para qué quieres usar tablas de clasificación y cuándo planeas enviar una puntuación de usuario. Cada puntaje de la tabla de clasificación será un número. Puedes configurar la tabla de clasificación para considerar los valores de números más bajos o más altos como mejores en términos de posición en la tabla de clasificación, pero, naturalmente, esto dependerá del propósito de tu juego.

El código en la carpeta de descargas incluye un juego simple en el que el usuario adivina un número. Usaremos el número de conjeturas requeridas para obtener la respuesta correcta como puntaje de la tabla de clasificación. En este caso, menos conjeturas son mejores, por lo que la clasificación presentará primero las puntuaciones más bajas. Para simplificar, limitaremos el número de conjeturas que un usuario puede realizar. Este es un ejemplo trivial para demostrar el concepto y la funcionalidad de la tabla de clasificación. Tus propios juegos probablemente implicarán más complejidad.

Paso 2

Preparemos Eclipse para desarrollar con Google Play Game Services. Abre Android SDK Manager y ve a la carpeta Extras. Expande la carpeta y selecciona Google Play Services más el Repositorio de Google. Instala Google APIs Platform desde una de las versiones recientes de Android si quieres probar en el emulador. Instala los paquetes elegidos.

Paso 3

Eclipse también deberá hacer referencia a algunos recursos adicionales en el área de trabajo. En tu computadora, navega a la ubicación de la Biblioteca de servicios de Google Play, que debe estar en la carpeta Android SDK, en extras/google/google_play_services/libproject/google-play-services_lib/. Copia y pega la biblioteca en otro lugar en tu computador.

Ahora necesitamos una referencia a esta copia en Eclipse. Selecciona Importar > Android > Importar código de Android existente en el espacio de trabajo en el menú Archivo. Selecciona la ubicación de la copia que hiciste. La biblioteca importada ahora debería aparecer como un nuevo proyecto en Eclipse. Haz clic con el botón derecho y selecciona Propiedades. En la sección Android, elige un objetivo de compilación de API de Google y marca la casilla de verificación Es Biblioteca.

Paso 4

La importación del recurso BaseGameUtils es ligeramente diferente. La biblioteca está alojada en GitHub. Puedes encontrarlo en la sección Descargas, en Juegos de ejemplo. Descarga la biblioteca y guárdala en tu computadora.

Como hiciste con la biblioteca de servicios de Google Play, selecciona Importar > Android > Importar código de Android existente en el espacio de trabajo en el menú Archivo para llevar la biblioteca BaseGameUtils a Eclipse. Haz clic con el botón derecho para navegar a las nuevas propiedades del proyecto y asegúrate de que el proyecto esté marcado como biblioteca al marcar Es Biblioteca.

Paso 5

Ahora podemos hacer que la aplicación haga referencia a estos dos recursos dentro del espacio de trabajo. Haz clic derecho en tu aplicación en el Explorador de paquetes y elige Propiedades. Navega a la sección Android y selecciona Agregar en la sección Biblioteca. Elige tanto la biblioteca de Servicios de Google Play como BaseGameUtils y agrégalos a tu aplicación.

2. Prepara tu juego en la consola de desarrollo

Paso 1

Antes de que puedas crear una tabla de clasificación, la aplicación debe aparecer en la Consola para programadores de Google Play. Inicia sesión y haz clic en el botón de la izquierda Game Services . Si ya hiciste esto para tu aplicación en el tutorial de logros, no necesitas hacerlo nuevamente. Puedes pasar a la sección 3 sobre cómo crear una tabla de clasificación.

Haz clic en Configurar servicios de juegos de Google Play.

Haz clic para agregar un nuevo juego, selecciona No uso API de Google en mi juego todavía, y elige un nombre y categoría para tu juego. Haz clic en Continuar para ir al siguiente paso.

Agrega el título de tu juego. Puedes agregar otros detalles más adelante.

Paso 2

Vamos a vincular la aplicación para que podamos consultar esta lista de la Consola de Desarrollador en la propia aplicación. Haz clic en la entrada Aplicaciones vinculadas en la lista de la izquierda y elige Android.

Ingresa la información de tu aplicación, incluido el nombre del paquete, asegurándote de que sea igual a la que estás utilizando en tu proyecto.

Guarda y haz clic en Autorizar tu aplicación ahora. Por el momento, puedes agregar el nombre de la aplicación, pero puedes ingresar más detalles más adelante. Elige Aplicación instalada en el área ID de cliente, con Android como tipo e ingresa el nombre de tu paquete. Ahora necesitas usar la utilidad keytool para generar un certificado de firma. Puedes usar el siguiente comando en una terminal o símbolo del sistema en combinación con el certificado de depuración:

1	keytool -exportcert -alias androiddebugkey -keystore ~/.android/debug.keystore -list -v

La terminal o símbolo del sistema escribirá la huella digital del certificado. Copia lo que ves después de SHA1 y pégalo en Developer Console en el área de texto de Huella digital de certificado de firma.

Selecciona Crear cliente y copia la ID de la aplicación, que se muestra junto al nombre de la aplicación en Developer Console. Agregarás el ID a tu aplicación junto con el ID de la tabla de clasificación que estamos por crear.

3. Crea una tabla de clasificación

Paso 1

Todavía en Developer Console, creemos ahora una nueva tabla de clasificación. Selecciona la sección Tablas de clasificación en tu lista de aplicaciones y haz clic en Agregar tabla de líderes.

Asegúrate de comprender el concepto de Tablas de clasificación en Android y, en general, en los Servicios de juegos de Google Play. Puedes leer una descripción general en el sitio web de Google Play Game Services. En realidad, puedes hacer muchas cosas diferentes con tablas de clasificación, así que considera que lo que hacemos en este tutorial es solo un punto de partida.

Ingresa los detalles de tu nueva tabla de clasificación. Para nuestro código de muestra, usamos el nombre Menos conjeturas y seleccionamos Más pequeño es mejor en la sección Ordenar.

Agrega un icono si lo deseas. Si no lo haces, se usará una imagen estándar. Guarda tu nueva tabla de clasificación y copia tu ID.

Paso 2

En la sección Pruebas de tu aplicación en Developer Console, puedes agregar cuentas a las que se les otorgará acceso para probar el juego. De forma predeterminada, verás tu propio correo electrónico de la cuenta de Google allí enumerado, por lo que deberías poder usarlo para probar tu aplicación.

4. Prepara tu juego para acceder a los servicios de juegos

Paso 1

Es hora de preparar la aplicación para acceder a la tabla de líderes en Eclipse. Si completaste el tutorial de logros, puedes omitir parte de esta sección. Primero agreguemos los ID para la aplicación y la tabla de clasificación. Abre o crea un archivo de recursos res/values/ids.xml. Usa la siguiente sintaxis para ingresar los ID que copiaste para la aplicación y la nueva tabla de clasificación cuando los creaste en Developer Console:

1	<string name="app_id">1234567890</string>
2	<string name="number_guesses_leaderboard">abcdefg1234567</string>

Guarda el archivo y abre el Manifiesto del proyecto. Agrega lo siguiente dentro del elemento application:

<meta-data
 android:name="com.google.android.gms.games.APP_ID"
 android:value="@string/app_id" />
<meta-data
 android:name="com.google.android.gms.version"
 android:value="@integer/google_play_services_version" />

La aplicación ahora está configurada para vincular a los listados que agregamos en Developer Console.

Paso 2

Cuando utilizas los servicios de Google en tus aplicaciones Android, necesitas que tus usuarios inicien sesión en sus cuentas de Google. Puedes tomar varios enfoques para implementar esto, pero vamos a automatizar partes de este proceso utilizando la clase BaseGameActivity junto con botones estándar para iniciar y cerrar sesión. Además, cuando se inicia la actividad, la aplicación intentará iniciar sesión en el usuario de inmediato.

Abre el archivo de diseño principal de tu aplicación y agrega botones para iniciar/cerrar sesión:

<!-- sign-in button -->

<com.google.android.gms.common.SignInButton
 android:id="@+id/sign_in_button"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content" />

<!-- sign-out button -->

<Button
 android:id="@+id/sign_out_button"
 android:layout_width="wrap_content"
 android:layout_height="wrap_content"
 android:text="Sign Out"
 android:visibility="gone" />

Paso 3

Agrega estas importaciones a tu clase principal Activity:

1	import com.google.android.gms.games.Games;
2	import com.google.example.games.basegameutils.BaseGameActivity;

Haz que la clase Activity amplíe la clase BaseGameActivity y recepcione si hay clics:

1	public class MainActivity extends BaseGameActivity implements View.OnClickListener

Prepárate para responder a los clics en los botones para iniciar o cerrar sesión en onCreate:

1	findViewById(R.id.sign_in_button).setOnClickListener(this);
2	findViewById(R.id.sign_out_button).setOnClickListener(this);

Ahora agrega los siguientes métodos estándar a un método onClick en la clase:

@Override
public void onClick(View view) {
    if (view.getId() == R.id.sign_in_button) {
  	beginUserInitiatedSignIn();
	}
	else if (view.getId() == R.id.sign_out_button) {
		signOut();
		findViewById(R.id.sign_in_button).setVisibility(View.VISIBLE);
		findViewById(R.id.sign_out_button).setVisibility(View.GONE);
	}
}

Los métodos que llamamos aquí los proporciona la clase BaseGameActivity de la que hereda nuestra clase Activity, por lo que no es necesario que manejemos los detalles de forma manual. Finalmente, agregamos un par de devoluciones de llamada estándar:

public void onSignInSucceeded() {
    findViewById(R.id.sign_in_button).setVisibility(View.GONE);
	findViewById(R.id.sign_out_button).setVisibility(View.VISIBLE);
}

@Override
public void onSignInFailed() {
	findViewById(R.id.sign_in_button).setVisibility(View.VISIBLE);
	findViewById(R.id.sign_out_button).setVisibility(View.GONE);
}

Cuando recurrimos a la funcionalidad de la tabla de clasificación, primero verificaremos si la aplicación tiene conexión con los servicios de Google. Alternativamente, puedes agregar código a estos métodos para administrar la conciencia de tu aplicación sobre si se puede llamar o no a Play Services.

5. Implementa tu tabla de clasificación

Paso 1

Ahora podemos dejar que la aplicación use la tabla de clasificación. El código en la aplicación de muestra usa el siguiente diseño. No entraré en detalles para explicar el diseño ya que tus propias aplicaciones tendrán un diseño diferente.

<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
	android:layout_width="match_parent"
	android:layout_height="match_parent"
	android:paddingBottom="@dimen/activity_vertical_margin"
	android:paddingLeft="@dimen/activity_horizontal_margin"
	android:paddingRight="@dimen/activity_horizontal_margin"
	android:paddingTop="@dimen/activity_vertical_margin"
	tools:context="com.example.fungame.MainActivity" >

	<LinearLayout
		android:id="@+id/sign_in_buttons"
		android:layout_width="fill_parent"
		android:layout_height="wrap_content"
		android:layout_alignParentTop="true"
		android:orientation="horizontal" >

		<!-- sign-in button -->

		<com.google.android.gms.common.SignInButton
			android:id="@+id/sign_in_button"
			android:layout_width="wrap_content"
			android:layout_height="wrap_content" />

		<!-- sign-out button -->

		<Button
			android:id="@+id/sign_out_button"
			android:layout_width="wrap_content"
			android:layout_height="wrap_content"
			android:text="Sign Out"
			android:visibility="gone" />
	</LinearLayout>

	<RelativeLayout
		android:id="@+id/gameArea"
		android:layout_width="fill_parent"
		android:layout_height="wrap_content"
		android:layout_below="@id/sign_in_buttons" >

		<TextView
			android:id="@+id/guess_text"
			android:layout_width="fill_parent"
			android:layout_height="wrap_content"
			android:layout_centerHorizontal="true"
			android:text="Guess the number!"
			android:textSize="30sp"
			android:textStyle="bold" />

		<LinearLayout
			android:layout_width="fill_parent"
			android:layout_height="wrap_content"
			android:layout_below="@id/guess_text"
			android:orientation="vertical" >

			<LinearLayout
				android:layout_width="fill_parent"
				android:layout_height="wrap_content"
				android:orientation="horizontal" >

				<Button
					android:id="@+id/btn7"
					android:layout_width="0dp"
					android:layout_height="match_parent"
					android:layout_margin="1dp"
					android:layout_weight="1"
					android:background="#ff000033"
					android:gravity="center"
					android:onClick="btnPressed"
					android:padding="5dp"
					android:tag="7"
					android:text="7"
					android:textColor="#ffffffff"
					android:textSize="30sp"
					android:textStyle="bold" />

				<Button
					android:id="@+id/btn8"
					android:layout_width="0dp"
					android:layout_height="match_parent"
					android:layout_margin="1dp"
					android:layout_weight="1"
					android:background="#ff000033"
					android:gravity="center"
					android:onClick="btnPressed"
					android:padding="5dp"
					android:tag="8"
					android:text="8"
					android:textColor="#ffffffff"
					android:textSize="30sp"
					android:textStyle="bold" />

				<Button
					android:id="@+id/btn9"
					android:layout_width="0dp"
					android:layout_height="match_parent"
					android:layout_margin="1dp"
					android:layout_weight="1"
					android:background="#ff000033"
					android:gravity="center"
					android:onClick="btnPressed"
					android:padding="5dp"
					android:tag="9"
					android:text="9"
					android:textColor="#ffffffff"
					android:textSize="30sp"
					android:textStyle="bold" />
			</LinearLayout>

			<LinearLayout
				android:layout_width="fill_parent"
				android:layout_height="wrap_content"
				android:layout_weight="1"
				android:orientation="horizontal" >

				<Button
					android:id="@+id/btn4"
					android:layout_width="0dp"
					android:layout_height="match_parent"
					android:layout_margin="1dp"
					android:layout_weight="1"
					android:background="#ff000033"
					android:gravity="center"
					android:onClick="btnPressed"
					android:padding="5dp"
					android:tag="4"
					android:text="4"
					android:textColor="#ffffffff"
					android:textSize="30sp"
					android:textStyle="bold" />

				<Button
					android:id="@+id/btn5"
					android:layout_width="0dp"
					android:layout_height="match_parent"
					android:layout_margin="1dp"
					android:layout_weight="1"
					android:background="#ff000033"
					android:gravity="center"
					android:onClick="btnPressed"
					android:padding="5dp"
					android:tag="5"
					android:text="5"
					android:textColor="#ffffffff"
					android:textSize="30sp"
					android:textStyle="bold" />

				<Button
					android:id="@+id/btn6"
					android:layout_width="0dp"
					android:layout_height="match_parent"
					android:layout_margin="1dp"
					android:layout_weight="1"
					android:background="#ff000033"
					android:gravity="center"
					android:onClick="btnPressed"
					android:padding="5dp"
					android:tag="6"
					android:text="6"
					android:textColor="#ffffffff"
					android:textSize="30sp"
					android:textStyle="bold" />
			</LinearLayout>

			<LinearLayout
				android:layout_width="fill_parent"
				android:layout_height="wrap_content"
				android:layout_weight="1"
				android:orientation="horizontal" >

				<Button
					android:id="@+id/btn1"
					android:layout_width="0dp"
					android:layout_height="match_parent"
					android:layout_margin="1dp"
					android:layout_weight="1"
					android:background="#ff000033"
					android:gravity="center"
					android:onClick="btnPressed"
					android:padding="5dp"
					android:tag="1"
					android:text="1"
					android:textColor="#ffffffff"
					android:textSize="30sp"
					android:textStyle="bold" />

				<Button
					android:id="@+id/btn2"
					android:layout_width="0dp"
					android:layout_height="match_parent"
					android:layout_margin="1dp"
					android:layout_weight="1"
					android:background="#ff000033"
					android:gravity="center"
					android:onClick="btnPressed"
					android:padding="5dp"
					android:tag="2"
					android:text="2"
					android:textColor="#ffffffff"
					android:textSize="30sp"
					android:textStyle="bold" />

				<Button
					android:id="@+id/btn3"
					android:layout_width="0dp"
					android:layout_height="match_parent"
					android:layout_margin="1dp"
					android:layout_weight="1"
					android:background="#ff000033"
					android:gravity="center"
					android:onClick="btnPressed"
					android:padding="5dp"
					android:tag="3"
					android:text="3"
					android:textColor="#ffffffff"
					android:textSize="30sp"
					android:textStyle="bold" />
			</LinearLayout>

			<LinearLayout
				android:layout_width="fill_parent"
				android:layout_height="wrap_content"
				android:layout_weight="1"
				android:orientation="horizontal" >

				<Button
					android:id="@+id/btn0"
					android:layout_width="0dp"
					android:layout_height="match_parent"
					android:layout_margin="1dp"
					android:layout_weight="1"
					android:background="#ff000033"
					android:gravity="center"
					android:onClick="btnPressed"
					android:padding="5dp"
					android:tag="0"
					android:text="0"
					android:textColor="#ffffffff"
					android:textSize="30sp"
					android:textStyle="bold" />

				<Button
					android:id="@+id/btnAgain"
					android:layout_width="0dp"
					android:layout_height="match_parent"
					android:layout_margin="1dp"
					android:layout_weight="1"
					android:background="#ffffff00"
					android:enabled="false"
					android:gravity="center"
					android:onClick="btnPressed"
					android:padding="5dp"
					android:tag="-1"
					android:text="Again"
					android:textColor="#ffffff00"
					android:textSize="30sp"
					android:textStyle="bold" />
			</LinearLayout>
		</LinearLayout>
	</RelativeLayout>

	<LinearLayout
		android:id="@+id/play_buttons"
		android:layout_width="fill_parent"
		android:layout_height="wrap_content"
		android:layout_below="@id/gameArea"
		android:gravity="center"
		android:orientation="horizontal" >

		<!-- show achievements -->

		<Button
			android:id="@+id/show_achievements"
			android:layout_width="wrap_content"
			android:layout_height="wrap_content"
			android:text="Achievements" />

		<!-- show leaderboards -->

		<Button
			android:id="@+id/show_leaderboard"
			android:layout_width="wrap_content"
			android:layout_height="wrap_content"
			android:text="Leaderboard" />
	</LinearLayout>

</RelativeLayout>

Agregamos botones para acceder a los logros y tablas de clasificación de la aplicación. Si no has completado el tutorial de logros, puedes eliminar el botón de logros.

De regreso a la clase de Activity de tu aplicación, usaremos estas variables de instancia:

private Button button0, button1, button2, button3, button4, button5,
    button6, button7, button8, button9, buttonAgain;
private int number;
private Random rand;
private TextView info;
private int numGuesses=0;

Si completaste el tutorial de logros, puedes observar una variable adicional, numGuesses, para realizar un seguimiento del número de conjeturas del usuario cada vez que juegan el juego.

Necesitarás el siguiente código adicional en el método onCreate de la clase Activity. Si no estás utilizando el botón de logros, elimina la línea que lo referencia.

findViewById(R.id.show_achievements).setOnClickListener(this);
findViewById(R.id.show_leaderboard).setOnClickListener(this);

button0=(Button)findViewById(R.id.btn0);
button1=(Button)findViewById(R.id.btn1);
button2=(Button)findViewById(R.id.btn2);
button3=(Button)findViewById(R.id.btn3);
button4=(Button)findViewById(R.id.btn4);
button5=(Button)findViewById(R.id.btn5);
button6=(Button)findViewById(R.id.btn6);
button7=(Button)findViewById(R.id.btn7);
button8=(Button)findViewById(R.id.btn8);
button9=(Button)findViewById(R.id.btn9);
buttonAgain=(Button)findViewById(R.id.btnAgain);

info=(TextView)findViewById(R.id.guess_text);

rand=new Random();
number=rand.nextInt(10);

También usamos los siguientes métodos para deshabilitar y habilitar los botones durante el juego:

private void disableNumbers(){
    button0.setEnabled(false); button0.setTextColor(Color.parseColor("#ff000033"));
	button1.setEnabled(false); button1.setTextColor(Color.parseColor("#ff000033"));
	button2.setEnabled(false); button2.setTextColor(Color.parseColor("#ff000033"));
	button3.setEnabled(false); button3.setTextColor(Color.parseColor("#ff000033"));
	button4.setEnabled(false); button4.setTextColor(Color.parseColor("#ff000033"));
	button5.setEnabled(false); button5.setTextColor(Color.parseColor("#ff000033"));
	button6.setEnabled(false); button6.setTextColor(Color.parseColor("#ff000033"));
	button7.setEnabled(false); button7.setTextColor(Color.parseColor("#ff000033"));
	button8.setEnabled(false); button8.setTextColor(Color.parseColor("#ff000033"));
	button9.setEnabled(false); button9.setTextColor(Color.parseColor("#ff000033"));
	buttonAgain.setEnabled(true); buttonAgain.setTextColor(Color.parseColor("#ff000033"));
}
private void enableNumbers(){
	button0.setEnabled(true); button0.setTextColor(Color.WHITE);
	button1.setEnabled(true); button1.setTextColor(Color.WHITE);
	button2.setEnabled(true); button2.setTextColor(Color.WHITE);
	button3.setEnabled(true); button3.setTextColor(Color.WHITE);
	button4.setEnabled(true); button4.setTextColor(Color.WHITE);
	button5.setEnabled(true); button5.setTextColor(Color.WHITE);
	button6.setEnabled(true); button6.setTextColor(Color.WHITE);
	button7.setEnabled(true); button7.setTextColor(Color.WHITE);
	button8.setEnabled(true); button8.setTextColor(Color.WHITE);
	button9.setEnabled(true); button9.setTextColor(Color.WHITE);
	buttonAgain.setEnabled(false); buttonAgain.setTextColor(Color.parseColor("#ffffff00"));
}

También necesitamos el siguiente método que especificamos como atributo onClick para los botones numéricos en el diseño. El jugador toca uno de estos para hacer una suposición:

public void btnPressed(View v){
    int btn = Integer.parseInt(v.getTag().toString());
	if(btn<0){
		//again btn
		numGuesses=0;
		number=rand.nextInt(10);
		enableNumbers();
		info.setText("Set the number!");
	}
	else{
		//number button
		numGuesses++;
		if(btn==number){
			info.setText("Yes! It was "+number);
			if(getApiClient().isConnected()){
				Games.Achievements.unlock(getApiClient(), 
						getString(R.string.correct_guess_achievement));
				Games.Leaderboards.submitScore(getApiClient(), 
						getString(R.string.number_guesses_leaderboard), 
						numGuesses);
			}
			disableNumbers();
		}
		else if(numGuesses==5){
			info.setText("No! It was "+number);
			disableNumbers();
		}
		else
			info.setText("Try again!");
	}
}

Toma un momento para revisar el código. Incluso si completaste la aplicación en el tutorial de logros, hay algunos cambios en la lógica, además del código adicional de la tabla de clasificación. Si el jugador toca el botón Nuevamente, reiniciamos la variable numGuesses a 0. Si el usuario toca un botón numérico, aumentamos el valor num. Si no estás utilizando logros, puedes eliminar cualquier código que haga referencia a los logros.

Sometemos el puntaje a la tabla de clasificación cuando el usuario adivinó correctamente. El usuario puede hacer hasta cinco conjeturas.

La línea clave aquí es submitScore. Pasamos el número de conjeturas que el jugador tomó para obtener el número correcto. Si el número de conjeturas es menor que cualquier entrada existente para el usuario en la tabla de clasificación, su entrada será reemplazada por este nuevo valor. Ten en cuenta que usamos el valor del recurso de cadena que definimos para la tabla de clasificación.

Paso 2

Antes de terminar, permitamos que el usuario vea la tabla de líderes del juego al tocar el botón Leaderboard que agregamos. Usamos el siguiente código en onClick para los logros:

1	else if (view.getId() == R.id.show_achievements){
2	startActivityForResult(Games.Achievements.getAchievementsIntent(
3	getApiClient()), 1);
4	}

La presentación de la clasificación es similar:

else if(view.getId() == R.id.show_leaderboard){
    startActivityForResult(Games.Leaderboards.getLeaderboardIntent(
		getApiClient(), getString(R.string.number_guesses_leaderboard)), 
		2);
}

Esto permitirá al usuario ver la clasificación actual dentro de la tabla de clasificación. El parámetro entero es arbitrario.

Cuando ejecutas la aplicación, intentará iniciar sesión con el usuario, verificando los permisos y confirmando el inicio de sesión si es exitoso:

El usuario puede elegir cerrar la sesión y volver a ingresar cuando quiera, pero si abandona la aplicación, intentará volver a iniciar sesión automáticamente cuando la abra nuevamente. Cuando el usuario adivine correctamente, su puntaje se enviará a la tabla de clasificación. Al presionar el botón Leaderboard se mostrarán las clasificaciones actuales:

Desde aquí, el usuario puede acceder a las características sociales de los Servicios de Google a través de su cuenta de Google. Puedes configurar tus aplicaciones para usar tablas de clasificación públicas y sociales. Las tablas de clasificación sociales presentan listas de personas en los círculos del usuario, que se pueden administrar para el juego en sí. Para una clasificación pública, el usuario debe haber optado por compartir sus puntajes públicamente.

Conclusión

En este tutorial, hemos implementado la funcionalidad básica de una tabla de clasificación con Google Play Game Services. Ten en cuenta que puedes hacer mucho más con las tablas de clasificación en tus aplicaciones. Por ejemplo, puedes solicitar los datos de la tabla de clasificación para escalas de tiempo particulares, como diariamente, semanalmente y desde el orígen de todos los tiempos. Si una tabla de clasificación contiene muchos puntajes, es posible que tu aplicación solo obtenga los puntajes más altos o los puntajes más cercanos al jugador actual. Intenta experimentar con algunas de estas mejoras en tus propias aplicaciones.