Google Play Spiele-Dienste: Bestenlisten

German (Deutsch) translation by Valentina (you can also view the original English article)

Die Google Play Spiele-Dienste bieten die Möglichkeit, Ihren Spielen über die Google+ Konten der Nutzer soziale Funktionen hinzuzufügen. In diesem Tutorial zeigen wir Ihnen, wie Sie einer Android-App Bestenlisten hinzufügen, Benutzerbewertungen einreichen und die aktuelle Rangliste innerhalb des Spiels präsentieren können.

Das Verwenden von Bestenlisten umfasst das Vorbereiten Ihrer IDE, das Konfigurieren der Bestenliste in der Google Play Entwickler-Konsole und das Hinzufügen von Funktionen zu Ihrer App.

Wenn Sie das kürzlich durchgeführte Tutorial zum Hinzufügen von Erfolgen zu Android-Apps abgeschlossen haben, können Sie einige der Schritte in diesem Schritt überspringen. Der angehängte Quellcode enthält dieselbe App, die wir für das Tutorial für Erfolge verwendet haben, wobei sowohl Funktionen für Erfolge als auch Bestenlisten hinzugefügt wurden.

1. Bereiten Sie Ihre IDE vor

Schritt 1

Um Google Play Dienste nutzen zu können, müssen bestimmte Dienstprogramme in Ihrer Entwicklungsumgebung installiert sein. Da wir Game Services verwenden, werden wir außerdem die BaseGameUtils-Bibliothek installieren, wodurch sich der Codierungsaufwand für die Implementierung von Funktionen wie der Google+ Anmeldung verringert.

Erstellen Sie zunächst eine neue App oder verwenden Sie eine vorhandene. Wenn Sie dem Leistungs-Tutorial gefolgt sind, können Sie die App verwenden, die Sie für dieses Tutorial erstellt haben. Wenn Sie Ihr eigenes Spiel erstellen, entscheiden Sie, wofür Sie Bestenlisten verwenden möchten und wann Sie eine Benutzerbewertung einreichen möchten. Jede Rangliste wird eine Zahl sein. Sie können die Rangliste so konfigurieren, dass niedrigere oder höhere Zahlenwerte in Bezug auf die Position in der Rangliste als besser angesehen werden. Dies hängt jedoch natürlich vom Zweck Ihres Spiels ab.

Der Code im Download-Ordner enthält ein einfaches Spiel, in dem der Benutzer eine Zahl errät. Wir werden die Anzahl der Vermutungen, die erforderlich sind, um die richtige Antwort zu erhalten, als Ranglistenpunktzahl verwenden. In diesem Fall sind weniger Vermutungen besser, sodass die Rangliste zuerst die niedrigsten Punktzahlen anzeigt. Der Einfachheit halber begrenzen wir die Anzahl der Vermutungen, die ein Benutzer treffen kann. Dies ist ein einfaches Beispiel, um das Konzept und die Funktionalität der Bestenliste zu demonstrieren. Ihre eigenen Spiele werden wahrscheinlich komplexer sein.

Schritt 2

Bereiten wir Eclipse für die Entwicklung mit Google Play Spiel-Dienste vor. Öffnen Sie den Android SDK Manager und scrollen Sie zum Ordner Extras. Erweitern Sie den Ordner und wählen Sie Google Play Dienste sowie das Google Repository aus. Installieren Sie die Google APIs-Plattform auch von einer der neuesten Android-Versionen, wenn Sie auf dem Emulator testen möchten. Installieren Sie die ausgewählten Pakete.

Schritt 3

Eclipse muss auch auf einige zusätzliche Ressourcen im Arbeitsbereich verweisen. Navigieren Sie auf Ihrem Computer unter extras/google/google_play_services/libproject/google-play-services_lib/ zum Speicherort der Google Play Dienste-Bibliothek, die sich im Android SDK-Ordner befinden sollte. Kopieren Sie die Bibliothek und fügen Sie sie an einer anderen Stelle auf Ihrem Computer ein.

Wir brauchen jetzt einen Verweis auf diese Kopie in Eclipse. Wählen Sie im Menü Datei die Option Importieren > Android > Vorhandenen Android-Code in den Arbeitsbereich importieren. Wählen Sie den Speicherort der von Ihnen erstellten Kopie. Die importierte Bibliothek sollte jetzt als neues Projekt in Eclipse angezeigt werden. Klicken Sie mit der rechten Maustaste darauf und wählen Sie Eigenschaften. Wählen Sie im Android-Bereich ein Build-Ziel für Google APIs aus und aktivieren Sie das Kontrollkästchen Ist Bibliothek.

Schritt 4

Das Importieren der BaseGameUtils-Ressource unterscheidet sich geringfügig. Die Bibliothek wird auf GitHub gehostet. Sie finden es im Bereich Downloads unter Beispielspiele. Laden Sie die Bibliothek herunter und speichern Sie sie auf Ihrem Computer.

Wählen Sie wie bei der Google Play Services-Bibliothek im Menü Datei die Option Importieren > Android > Vorhandenen Android-Code in den Arbeitsbereich importieren, um die BaseGameUtils-Bibliothek in Eclipse zu integrieren. Klicken Sie mit der rechten Maustaste, um zu den neuen Projekteigenschaften zu navigieren und sicherzustellen, dass das Projekt als Bibliothek markiert ist, indem Sie Ist Bibliothek aktivieren.

Schritt 5

Wir können die App jetzt dazu bringen, auf diese beiden Ressourcen im Arbeitsbereich zu verweisen. Klicken Sie im Paket-Explorer mit der rechten Maustaste auf Ihre App und wählen Sie Eigenschaften. Navigieren Sie zum Android-Bereich und wählen Sie im Bereich Bibliothek die Option Hinzufügen. Wählen Sie sowohl die Google Play Dienste-Bibliothek als auch BaseGameUtils aus und fügen Sie sie Ihrer App hinzu.

2. Bereiten Sie Ihr Spiel in der Entwicklerkonsole vor

Schritt 1

Bevor Sie eine Rangliste erstellen können, muss die App in der Google Play Entwickler-Konsole aufgeführt sein. Melden Sie sich an und klicken Sie links auf die Schaltfläche Spiel-Dienste. Wenn Sie dies bereits im Leistungs-Tutorial für Ihre App getan haben, müssen Sie es nicht erneut ausführen. Sie können zum Erstellen einer Rangliste mit Abschnitt 3 springen.

Klicken Sie auf Google Play-Spiel-Dienste einrichten.

Klicken Sie hier, um ein neues Spiel hinzuzufügen, wählen Sie Ich verwende noch keine Google-APIs in meinem Spiel und wählen Sie einen Namen und eine Kategorie für Ihr Spiel. Klicken Sie auf Weiter, um mit dem nächsten Schritt fortzufahren.

Fügen Sie den Titel Ihres Spiels hinzu. Sie können später weitere Details hinzufügen.

Schritt 2

Verknüpfen wir nun die App, damit wir in der App selbst auf diese Liste der Entwicklerkonsolen verweisen können. Klicken Sie links in der Liste auf den Eintrag Verknüpfte Apps und wählen Sie Android.

Geben Sie Ihre App-Informationen einschließlich des Paketnamens ein und stellen Sie sicher, dass diese mit denen übereinstimmen, die Sie in Ihrem Projekt verwenden.

Speichern Sie und klicken Sie auf Jetzt Ihre App autorisieren. Im Moment können Sie einfach den App-Namen hinzufügen, aber Sie können später weitere Details eingeben. Wählen Sie im Bereich Client-ID die Option Installierte Anwendung mit Android als Typ und geben Sie Ihren Paketnamen ein. Sie müssen jetzt das Dienstprogramm keytool verwenden, um ein Signaturzertifikat zu generieren. Sie können den folgenden Befehl in einem Terminal oder einer Eingabeaufforderung in Kombination mit dem Debug-Zertifikat verwenden:

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

Das Terminal oder die Eingabeaufforderung schreibt den Fingerabdruck für das Zertifikat aus. Kopieren Sie das, was Sie nach SHA1 sehen, und fügen Sie es in die Entwicklerkonsole im Textbereich Signaturzertifikat-Fingerabdruck ein.

Wählen Sie Client erstellen und kopieren Sie die ID für die Anwendung, die neben dem Anwendungsnamen in der Entwicklerkonsole aufgeführt ist. Sie fügen Ihrer App die ID zusammen mit der ID für die Bestenliste hinzu, die wir erstellen möchten.

3. Erstellen Sie eine Bestenliste

Schritt 1

Lassen Sie uns jetzt in der Entwicklerkonsole eine neue Bestenliste erstellen. Wählen Sie den Abschnitt Bestenlisten in Ihrer App-Liste aus und klicken Sie auf Bestenliste hinzufügen.

Stellen Sie sicher, dass Sie das Konzept der Bestenlisten unter Android und allgemein in Google Play Game Dienste verstehen. Sie können eine Übersicht auf der Website von Google Play Game Dienste lesen. Mit Bestenlisten können Sie tatsächlich viele verschiedene Dinge tun. Betrachten Sie also, was wir in diesem Tutorial tun, nur als Ausgangspunkt.

Geben Sie die Details für Ihre neue Rangliste ein. Für unseren Beispielcode verwenden wir den Namen "Least Guesses" und wählen im Abschnitt "Bestellen" die Option "Kleiner ist besser".

Fügen Sie ein Symbol hinzu, wenn Sie möchten. Wenn Sie dies nicht tun, wird ein Standardbild verwendet. Speichern Sie Ihre neue Rangliste und kopieren Sie ihre ID.

Schritt 2

Im Abschnitt Testen für Ihre App in der Entwicklerkonsole können Sie Konten hinzufügen, denen Zugriff zum Testen des Spiels gewährt wird. Standardmäßig wird dort Ihre eigene Google-Konto-E-Mail-Adresse angezeigt, sodass Sie sie zum Testen Ihrer App verwenden können sollten.

4. Vorbereiten Ihres Spiels für den Zugriff auf Spieledienste

Schritt 1

Es ist Zeit, die App für den Zugriff auf die Bestenliste in Eclipse vorzubereiten. Wenn Sie das Tutorial für Erfolge abgeschlossen haben, können Sie einen Teil dieses Abschnitts überspringen. Fügen wir zunächst die IDs für die App und die Bestenliste hinzu. Öffnen oder erstellen Sie eine Ressourcendatei res/values/ids.xml. Verwenden Sie die folgende Syntax, um die IDs einzugeben, die Sie für die App und die neue Bestenliste kopiert haben, als Sie sie in der Entwicklerkonsole erstellt haben:

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

Speichern Sie die Datei und öffnen Sie das Manifest des Projekts. Fügen Sie dem application-Element Folgendes hinzu:

<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" />

Die App ist jetzt so eingerichtet, dass sie mit den Einträgen verknüpft ist, die wir in der Entwicklerkonsole hinzugefügt haben.

Schritt 2

Wenn Sie Google Dienste in Ihren Android-Apps verwenden, müssen sich Ihre Nutzer in ihren Google-Konten anmelden. Sie können verschiedene Ansätze wählen, um dies zu implementieren. Wir werden jedoch Teile dieses Prozesses automatisieren, indem wir die BaseGameActivity-Klasse zusammen mit Standardschaltflächen zum An- und Abmelden verwenden. Wenn die Aktivität startet, versucht die App außerdem, den Benutzer sofort anzumelden.

Öffnen Sie die Hauptlayoutdatei Ihrer App und fügen Sie Schaltflächen zum An- und Abmelden hinzu:

<!-- 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" />

Schritt 3

Fügen Sie diese Importe Ihrer Haupt-Aktivity-Klasse hinzu:

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

Lassen Sie die Activity-Klasse die BaseGameActivity-Klasse erweitern und auf Klicks warten:

1	public class MainActivity extends BaseGameActivity implements View.OnClickListener

Bereiten Sie sich darauf vor, auf Klicks auf die Anmelde-/Abmeldeschaltflächen in onCreate zu reagieren:

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

Fügen Sie nun einer onClick-Methode in der Klasse die folgenden Standardmethoden hinzu:

@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);
	}
}

Die Methoden, die wir hier aufrufen, werden von der BaseGameActivity-Klasse bereitgestellt, von der unsere Activity-Klasse erbt, sodass wir die Details nicht manuell verarbeiten müssen. Schließlich fügen wir einige Standardrückrufe hinzu:

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);
}

Wenn wir die Leaderboard-Funktionalität aufrufen, überprüfen wir zunächst, ob die App eine Verbindung zu Google Dienste hat. Alternativ können Sie diesen Methoden Code hinzufügen, um die Kenntnis Ihrer App darüber zu verwalten, ob Spiel-Dienste aufgerufen werden können.

5. Implementieren Sie Ihre Bestenliste

Schritt 1

Jetzt können wir die App die Bestenliste verwenden lassen. Der Code in der Beispiel-App verwendet das folgende Layout. Ich werde nicht näher auf das Layout eingehen, da Ihre eigenen Apps ein anderes Layout haben.

<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>

Wir fügen Schaltflächen hinzu, um sowohl auf Erfolge als auch auf Bestenlisten für die App zuzugreifen. Wenn Sie das Tutorial für Erfolge noch nicht abgeschlossen haben, können Sie die Schaltfläche Erfolge entfernen.

Zurück in der Aktivity-Klasse Ihrer Anwendung verwenden wir die folgenden Instanzvariablen:

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;

Wenn Sie das Tutorial für Erfolge abgeschlossen haben, werden Sie möglicherweise eine zusätzliche Variable, numGuesses, bemerken, um die Anzahl der Benutzerschätzungen jedes Mal zu verfolgen, wenn sie das Spiel spielen.

Sie benötigen den folgenden zusätzlichen Code in der onCreate-Methode der Activity-Klasse. Wenn Sie die Schaltfläche "Erfolge" nicht verwenden, entfernen Sie die Zeile, die darauf verweist.

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);

Wir verwenden auch die folgenden Methoden, um die Schaltflächen während des Spiels zu deaktivieren und zu aktivieren:

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"));
}

Wir benötigen außerdem die folgende Methode, die wir als onClick-Attribut für die Nummernschaltflächen im Layout angegeben haben. Der Spieler tippt auf eine davon, um eine Vermutung anzustellen:

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!");
	}
}

Nehmen Sie sich einen Moment Zeit, um den Code zu überprüfen. Selbst wenn Sie die App im Leistungs-Tutorial abgeschlossen haben, gibt es neben dem zusätzlichen Bestenliste-Code einige Änderungen an der Logik. Wenn der Spieler auf die Schaltfläche Erneut tippt, setzen wir die Variable numGuesses auf 0 zurück. Wenn der Benutzer auf eine Zifferntaste tippt, erhöhen wir numGuesses. Wenn Sie keine Erfolge verwenden, können Sie jeden Code entfernen, der auf Erfolge verweist.

Wir senden die Punktzahl an die Bestenliste, wenn der Benutzer richtig geraten hat. Der Benutzer kann bis zu fünf Vermutungen anstellen.

Die Schlüsselzeile hier ist submitScore. Wir geben die Anzahl der Vermutungen an, die der Spieler gemacht hat, um die richtige Anzahl zu erhalten. Wenn die Anzahl der Vermutungen geringer ist als ein vorhandener Eintrag für den Benutzer in der Bestenliste, wird dessen Eintrag durch diesen neuen Wert ersetzt. Beachten Sie, dass wir den Zeichenfolgenressourcenwert verwenden, den wir für die Bestenliste definiert haben.

Schritt 2

Bevor wir fertig sind, können die Benutzer die Bestenliste des Spiels anzeigen, indem sie auf die von uns hinzugefügte Schaltfläche "Bestenliste" tippen. Wir haben den folgenden Code in onClick für die Erfolge verwendet:

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

Die Präsentation der Bestenliste ist ähnlich:

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

Auf diese Weise kann der Benutzer die aktuelle Rangliste in der Rangliste anzeigen. Der Integer-Parameter ist beliebig.

Wenn Sie die App ausführen, wird versucht, den Benutzer anzumelden, nach Berechtigungen zu suchen und die Anmeldung zu bestätigen, wenn dies erfolgreich ist:

Dem Benutzer steht es frei, sich jederzeit abzumelden und wieder anzumelden. Wenn er die App verlässt, versucht er, sich automatisch wieder anzumelden, wenn er sie erneut öffnet. Wenn der Benutzer richtig vermutet, wird seine Punktzahl an die Rangliste übermittelt. Durch Drücken der Bestenliste-Taste wird die aktuelle Bestenliste angezeigt:

Von hier aus kann der Nutzer über sein Google-Konto auf soziale Funktionen von Google Services zugreifen. Sie können Ihre Apps so einrichten, dass sie öffentliche und soziale Bestenlisten verwenden. In sozialen Bestenlisten werden Listen von Personen in den Benutzerkreisen angezeigt, die für das Spiel selbst verwaltet werden können. Für eine öffentliche Rangliste muss sich der Benutzer dafür entschieden haben, seine Ergebnisse öffentlich zu teilen.

Abschluss

In diesem Tutorial haben wir grundlegende Bestenliste-Funktionen mit Google Play Spiel-Dienste implementiert. Beachten Sie, dass Sie mit Bestenlisten in Ihren Apps viel mehr tun können. Beispielsweise können Sie Bestenlisten-Daten für bestimmte Zeitskalen anfordern, z. B. täglich, wöchentlich und jederzeit. Wenn eine Rangliste viele Punkte enthält, kann Ihre App nur die besten oder die dem aktuellen Spieler am nächsten liegenden Punkte abrufen. Versuchen Sie, mit einigen dieser Verbesserungen in Ihren eigenen Apps zu experimentieren.