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 dein Spiel die Richtlinien zur Nutzerfreundlichkeit für Google Play Spiele Level Up erfüllt, 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-Spieldienste 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.
Empfohlener Authentifizierungsablauf
Damit Ihr Spiel die Richtlinien zur Nutzerfreundlichkeit für Google Play Spiele 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 Spiele-Dienstkonto. Ihr Spiel kann eine Spieler-ID für jeden Spieler abrufen, der sich mit der Authentifizierung der Play-Spieldienste in Ihrem Spiel anmeldet. Ihre Spieleclient-Integration, Spieleserver-Integration und Cloud-Speicherdienst können die ID verwenden, um sicher auf Spielerdaten aus Play-Spieldiensten zuzugreifen.
Eine Spieler-ID ist für einen Nutzer konsistent, wenn er Ihr Spiel auf mehreren Geräten spielt. Dies ist jedoch nicht immer bei allen Spielen der Fall. 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 verwenden einen anderen Bereich (drive.appdata), wenn Ihr Spiel die Funktion für gespeicherte Spiele nutzt. 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 mit den Play-Spieldiensten, einer ID für soziale Netzwerke und Ihrem eigenen In-Game-ID-System authentifizieren.
Recall API
Mit der Recall API können Spiele Links zwischen PGS-Nutzern und ihren In-Game-Konten verwalten, indem Recall-Tokens auf Google-Servern gespeichert werden. 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 gilt ein tägliches Kontingent. Weitere Informationen finden Sie unter Tageskontingent verwalten.