Wenn Sie Ihr Spiel in die Google Play-Spieldienste einbinden möchten, müssen Sie zuerst die Plattformauthentifizierung implementieren. Dies ist erforderlich, um auf alle anderen Funktionen wie Erfolge, Bestenlisten und Events zuzugreifen.
Damit Ihr Spiel den Richtlinien zur Nutzerfreundlichkeit für Google Play Spiele Level Up entspricht, muss es dem empfohlenen Authentifizierungsablauf entsprechen.
Initialisierung und Authentifizierung
Dieser Schritt ist erforderlich, um Ihr Spiel zu initialisieren und zu authentifizieren:
- Implementieren Sie die Plattformauthentifizierung, indem Sie das Play Games Services v2 SDK beim Start initialisieren. Weitere Informationen finden Sie unter Plattformauthentifizierung für Android-Spiele. Dieser Schritt ist erforderlich, um auf Play-Spieldienste-Funktionen wie Erfolge und Bestenlisten zuzugreifen.
- Die Authentifizierung wird beim Start des Spiels als lautloser Hintergrundprozess ausgeführt.
Vorhandene Nutzer der Play-Spieldienste sehen nach erfolgreicher Authentifizierung eine Willkommensnachricht.
Profilerstellung
Spieler benötigen ein Play-Spieldienste-Profil, um die Plattform nutzen zu können. Einige Spieler haben möglicherweise kein Play-Spieldienste-Profil, wenn sie Ihr Spiel starten. Diese Spieler werden aufgefordert, ein Konto zu erstellen.
Aufforderungen zur automatisch ausgelösten Profilerstellung werden standardmäßig automatisch angezeigt, wenn Sie ein Spiel ohne Play Spiele-Profil starten.
Empfohlene Authentifizierung
Damit Ihr Spiel die Richtlinien für die Nutzerfreundlichkeit von Google Play Games Level Up erfüllt, müssen Sie die Anforderungen an die Kontinuität für Spieler einhalten. Damit sich Spieler erfolgreich in Ihrem Spiel anmelden können, müssen Sie den folgenden Authentifizierungsablauf verwenden:
- Implementieren Sie während der Startsequenz Ihres Spiels die automatisch ausgelöste Profilerstellung.
- Wenn die automatische Authentifizierung fehlschlägt oder Sie sie ablehnen, zeigen Sie eine Schaltfläche für die manuelle Anmeldung an, damit Sie sich später authentifizieren können.
Spieler-ID
Eine Spieler-ID ist eine Kennung für ein Play-Spieldienste-Konto. Ihr Spiel kann eine Spieler-ID für jeden Spieler abrufen, der sich über die Authentifizierung über die Play-Spieldienste in Ihrem Spiel anmeldet. Ihre Spieleclient-Integration, Spieleserver-Integration und Cloud-Speicherdienst können mit der ID sicher auf Spielerdaten aus Play-Spieldiensten zugreifen.
Eine Spieler-ID bleibt für einen Nutzer gleich, wenn er Ihr Spiel auf mehreren Geräten spielt. Allerdings ist sie nicht immer konsistent. Weitere Informationen finden Sie unter Spieler-IDs der nächsten Generation.
OAuth-Bereiche
Die Play-Spieldienste nutzen das OAuth-System, damit Spieler Ihrem Spiel Zugriff auf ihr Konto gewähren können. Die Play-Spieldienste haben einen eindeutigen Bereich für Spiele (games-lite) und sind auf einen anderen Bereich (drive.appdata) angewiesen, wenn Ihr Spiel die Funktion für gespeicherte Spiele verwendet. Die Funktion „Gespeicherte Spiele“ bietet Zugriff auf das Google Drive-Konto des Nutzers, in dem die Spieldaten gespeichert sind.
Wenn Sie das Play-Spieldienste V2 SDK verwenden, können Sie zusätzliche OAuth-Bereiche anfordern.
Wenn Sie zusätzliche OAuth-Bereiche benötigen, empfehlen wir, requestServerSideAccess aufzurufen.
Weitere Informationen finden Sie unter Server-Autorisierungscode abrufen oder Server-Authentifizierungscodes abrufen.
Mehrere Authentifizierungsdienste
Die Play-Spieldienste bieten eine Gaming-Identität für Android-Spieler, aber sie muss nicht die einzige Identität sein, die mit Ihren Nutzern verknüpft ist. Sie können Spieler gleichzeitig über die Play-Spieldienste, eine ID eines sozialen Netzwerks und Ihr eigenes In-Game-ID-System authentifizieren.
Recall API
Mit der Recall API können Spiele Verknüpfungen zwischen Nutzern der Play-Spieldienste (PGS) und ihren In-Game-Konten verwalten, indem sie Speicherdaten-Tokens auf Google-Servern speichern. Weitere Informationen zum Aktivieren dieses Features finden Sie unter PGS Recall API in Ihr Spiel einbinden.
Integration des Spieleclients
Wenn Sie die Authentifizierung in Ihr Spielprojekt einbinden, empfehlen wir den folgenden Nutzerfluss:
Während der Startsequenz Ihres Spiels wird die Profilerstellung gestartet und es wird versucht, den Nutzer zu authentifizieren oder ein neues Konto zu erstellen.
Wenn die automatische Authentifizierung fehlschlägt oder Sie sie ablehnen, zeigen Sie eine Schaltfläche für die manuelle Anmeldung an, damit Sie sich später authentifizieren können.
Informationen zum Einbinden der Authentifizierung in Ihr Spielprojekt finden Sie in der Dokumentation für Ihren Projekttyp:
Gameserver-Integration
Sie können einen Serverautorisierungscode abrufen, indem Sie requestServerSideAccess aufrufen, nachdem Sie bestätigt haben, dass der Spieler authentifiziert ist. Übergeben Sie diesen Serverautorisierungscode an Ihren Backend-Spieleserver, um direkt mit den Play-Spieldienste-Servern zu kommunizieren. Durch diese Kommunikation kann Ihr Server auf Spielerdaten zugreifen, darunter:
- Spieler-ID
- Profil
- Kontaktliste
- Spielfortschritt
- Erfolge
Ihr Server verwendet diesen Autorisierungscode dann mit der REST API, um sicher mit den Play-Spieldienste-Servern zu interagieren. Weitere Informationen finden Sie unter Serverseitiger Zugriff auf Play-Spieldienste.
Kontingent für Anmeldeanfragen
Für Anmeldeanfragen mit den Play-Spieldiensten gibt es ein tägliches Kontingent. Weitere Informationen finden Sie unter Tageskontingent verwalten.