Freigeben über


Übersicht über die Services C-API – PFAuthenticationTypes.h

Strukturen

Struktur Beschreibung
PFAuthenticationAuthenticateCustomIdRequest PFAuthenticationAuthenticateCustomIdRequest-Datenmodell. Erstellen oder Zurückgeben eines game_server Entitätstokens. Aufrufer muss eine Titelentität sein.
PFAuthenticationAuthenticateCustomIdResult PFAuthenticationAuthenticateCustomIdResult-Datenmodell.
PFAuthenticationDeleteRequest PFAuthenticationDeleteRequest-Datenmodell. Löschen einer game_server Entität. Der Aufrufer kann die game_server Entität sein, die versucht, sich selbst zu löschen. Oder eine Titelentität, die versucht, game_server Entitäten für diesen Titel zu löschen.
PFAuthenticationEntityTokenResponse PFAuthenticationEntityTokenResponse-Datenmodell.
PFAuthenticationGetEntityRequest PFAuthenticationGetEntityRequest-Datenmodell. Diese API muss mit X-SecretKey-, X-Authentication- oder X-EntityToken-Headern aufgerufen werden. Ein optionaler EntityKey kann eingeschlossen werden, um zu versuchen, das resultierende EntityToken auf eine bestimmte Entität festzulegen. Die Entität muss jedoch eine Beziehung des Aufrufers sein, z. B. die master_player_account eines Zeichens. Beim Senden von X-EntityToken wird das Konto als neu angemeldet markiert und stellt ein neues Token aus. Bei Verwendung von X-Authentication oder X-EntityToken muss der Header weiterhin gültig sein und kann nicht abgelaufen oder widerrufen werden.
PFAuthenticationLoginResult PFAuthenticationLoginResult-Datenmodell.
PFAuthenticationLoginWithAppleRequest PFAuthenticationLoginWithAppleRequest-Datenmodell.
PFAuthenticationLoginWithCustomIDRequest PFAuthenticationLoginWithCustomIDRequest-Datenmodell. Es wird dringend empfohlen, dass Entwickler sicherstellen, dass es äußerst unwahrscheinlich ist, dass ein Kunde eine ID generiert, die bereits von einem anderen Kunden verwendet wird. Wenn sich ein Benutzer zum ersten Mal mit der benutzerdefinierten ID anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit der benutzerdefinierten ID verknüpft. In diesem Fall wird dem PlayFab-Konto keine E-Mail-Adresse oder kein Benutzername zugeordnet. Andernfalls wird ein Fehler zurückgegeben, wenn kein PlayFab-Konto mit der benutzerdefinierten ID verknüpft ist, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos leiten kann.
PFAuthenticationLoginWithFacebookRequest PFAuthenticationLoginWithFacebookRequest-Datenmodell. Facebook Anmeldung erfolgt mithilfe des Facebook-Benutzerzugriffstokens. Weitere Informationen zum Token finden Sie in der Facebook Entwicklerdokumentation (https://developers.facebook.com/docs/facebook-login/access-tokens/). In Unity ist das Token beispielsweise als AccessToken im Facebook SDK ScriptableObject FB verfügbar. Wenn sich ein Benutzer zum ersten Mal mit dem Facebook-Konto anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit der Facebook-ID des angegebenen Kontos verknüpft. In diesem Fall wird dem PlayFab-Konto keine E-Mail-Adresse oder kein Benutzername zugeordnet. Wenn andernfalls kein PlayFab-Konto mit dem Facebook-Konto verknüpft ist, wird ein Fehler zurückgegeben, der darauf hinweist, dass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Beachten Sie, dass Titel niemals die gleichen Facebook Anwendungen zwischen PlayFab-Titel-IDs wiederverwenden sollten, da Facebook eindeutige Benutzer-IDs pro Anwendung bereitstellt und dies zu Problemen mit der Facebook-ID für den Benutzer in seinen PlayFab-Kontoinformationen führen kann. Wenn Sie eine Anwendung in einer neuen PlayFab-Titel-ID erneut verwenden müssen, stellen Sie sicher, dass Sie zuerst die Verknüpfung aller Konten mit Facebook aufheben oder alle Benutzer in der ersten Titel-ID löschen.
PFAuthenticationLoginWithGameCenterRequest PFAuthenticationLoginWithGameCenterRequest-Datenmodell. Der Game Center-Spielerbezeichner (https://developer.apple.com/library/ios/documentation/Accounts/Reference/ACAccountClassRef/index.html# // apple_ref/occ/instp/ACAccount/identifier) ist eine generierte Zeichenfolge, die auf dem lokalen Gerät gespeichert wird. Wie bei Gerätebezeichnern muss darauf geachtet werden, dass die Game Center-ID eines Spielers niemals endbenutzerseitig verfügbar gemacht wird, da dies dazu führen kann, dass das Konto eines Benutzers kompromittiert wird. Wenn sich ein Benutzer zum ersten Mal mit Game Center anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit dem Game Center-Bezeichner verknüpft. In diesem Fall wird dem PlayFab-Konto keine E-Mail-Adresse oder kein Benutzername zugeordnet. Andernfalls wird, wenn kein PlayFab-Konto mit dem Game Center-Konto verknüpft ist, ein Fehler zurückgegeben, der darauf hinweist, dass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Wenn ein ungültiger iOS Game Center-Spielerbezeichner verwendet wird, wird ein Fehler zurückgegeben, der darauf hinweist.
PFAuthenticationLoginWithGoogleAccountRequest PFAuthenticationLoginWithGoogleAccountRequest-Datenmodell. Die Google-Anmeldung erfolgt durch Abrufen von Google OAuth 2.0-Anmeldeinformationen mithilfe der Google-Anmeldung für Android-APIs auf dem Gerät und Übergeben an diese API. Wenn sich ein Benutzer zum ersten Mal mit dem Google-Konto anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit dem Google-Konto verknüpft. Wenn kein PlayFab-Konto mit dem Google-Konto verknüpft ist, wird ein Fehler zurückgegeben, der darauf hinweist, dass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Die aktuelle (empfohlene) Methode zum Abrufen von Anmeldeinformationen für ein Google-Konto in einer Android-Anwendung besteht darin, GoogleSignInAccount.getServerAuthCode() aufzurufen und den Authentifizierungscode als ServerAuthCode-Parameter dieser API zu senden. Bevor Sie dies tun, müssen Sie eine OAuth 2.0-Webanwendungsclient-ID in der Google API-Konsole erstellen und deren Client-ID und geheimnis im Google-Add-On für PlayFab Game Manager für Ihren Titel konfigurieren. Diese Methode erfordert keine Aufforderung des Benutzers nach zusätzlichen Google-Kontoberechtigungen, was zu einer Benutzererfahrung mit der geringstmöglichen Reibung führt. Weitere Informationen zum Abrufen des Serverauthentifizierungscodes finden Sie unter https://developers.google.com/identity/sign-in/android/offline-access. Die vorherige (veraltete) Methode bestand darin, ein OAuth-Zugriffstoken abzurufen, indem GetAccessToken() auf dem Client aufgerufen und als AccessToken-Parameter an diese API übergeben wird. für die mit dem Google OAuth 2.0-Zugriffstoken. Weitere Informationen zu dieser Änderung finden Sie in der Google-Entwicklerdokumentation (https://android-developers.googleblog.com/2016/01/play-games-permissions-are-changing-in.html).
PFAuthenticationLoginWithGooglePlayGamesServicesRequest PFAuthenticationLoginWithGooglePlayGamesServicesRequest-Datenmodell. Die Google Play Games-Anmeldung erfolgt durch Abrufen von Google OAuth 2.0-Anmeldeinformationen mithilfe der Google Play Games-Anmeldung für Android-APIs auf dem Gerät und Übergeben an diese API. Wenn sich ein Benutzer zum ersten Mal mit dem Google Play Games-Konto anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit dem Google Play Games-Konto verknüpft. Wenn andernfalls kein PlayFab-Konto mit dem Google Play Games-Konto verknüpft ist, wird ein Fehler zurückgegeben, der darauf hinweist, dass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Die aktuelle (empfohlene) Methode zum Abrufen von Anmeldeinformationen für ein Google Play Games-Konto in einer Android-Anwendung besteht darin, GamesSignInClient.requestServerSideAccess() aufzurufen und den Authentifizierungscode als ServerAuthCode-Parameter dieser API zu senden. Bevor Sie dies tun, müssen Sie eine OAuth 2.0-Webanwendungsclient-ID in der Google API-Konsole erstellen und deren Client-ID und geheimnis im Google-Add-On für PlayFab Game Manager für Ihren Titel konfigurieren. Diese Methode erfordert keine Aufforderung des Benutzers nach zusätzlichen Google-Kontoberechtigungen, was zu einer Benutzererfahrung mit der geringstmöglichen Reibung führt. Weitere Informationen zum Abrufen des Serverauthentifizierungscodes finden Sie unter https://developers.google.com/games/services/android/signin.
PFAuthenticationLoginWithNintendoServiceAccountRequest PFAuthenticationLoginWithNintendoServiceAccountRequest-Datenmodell.
PFAuthenticationLoginWithOpenIdConnectRequest PFAuthenticationLoginWithOpenIdConnectRequest-Datenmodell.
PFAuthenticationLoginWithPSNRequest PFAuthenticationLoginWithPSNRequest-Datenmodell. Wenn sich ein Benutzer zum ersten Mal mit dem PlayStation ™️ Network-Konto anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit dem PlayStation ™️ Network-Konto verknüpft. In diesem Fall wird dem PlayFab-Konto keine E-Mail-Adresse oder kein Benutzername zugeordnet. Andernfalls wird ein Fehler zurückgegeben, wenn kein PlayFab-Konto mit dem PlayStation ™️ Network-Konto verknüpft ist, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos leiten kann.
PFAuthenticationLoginWithServerCustomIdRequest PFAuthenticationLoginWithServerCustomIdRequest-Datenmodell.
PFAuthenticationLoginWithSteamIdRequest PFAuthenticationLoginWithSteamIdRequest-Datenmodell. Wenn sich ein Benutzer zum ersten Mal mit der Steam-ID anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit dem Steam-Konto verknüpft. In diesem Fall wird dem PlayFab-Konto keine E-Mail-Adresse oder kein Benutzername zugeordnet. Andernfalls wird, wenn kein PlayFab-Konto mit dem Steam-Konto verknüpft ist, ein Fehler zurückgegeben, der darauf hinweist, dass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Steam-Benutzer, die nicht bei der Steam-Client-App angemeldet sind, lassen nur ihren Steam-Benutzernamen synchronisieren, andere Daten wie Währung und Land sind erst verfügbar, wenn sie sich anmelden, während der Client geöffnet ist.
PFAuthenticationLoginWithSteamRequest PFAuthenticationLoginWithSteamRequest-Datenmodell. Die Steam-Anmeldung erfolgt mit dem Steam-Sitzungsticket. Weitere Informationen zum Ticket finden Sie im Steamworks SDK hier: https://partner.steamgames.com/documentation/auth. HINWEIS: Damit die Steam-Authentifizierung funktioniert, muss der Titel mit der Steam-Anwendungs-ID und dem Web-API-Schlüssel im PlayFab Game Manager (unter Steam im Add-Ons Marketplace) konfiguriert werden. Sie können einen Web-API-Schlüssel auf der Seite Berechtigungen einer beliebigen Gruppe abrufen, die Ihrer App-ID auf der Steamworks-Website zugeordnet ist. Wenn sich ein Benutzer zum ersten Mal mit dem Steam-Konto anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit der Steam-ID des angegebenen Kontos verknüpft. In diesem Fall wird dem PlayFab-Konto keine E-Mail-Adresse oder kein Benutzername zugeordnet. Andernfalls wird, wenn kein PlayFab-Konto mit dem Steam-Konto verknüpft ist, ein Fehler zurückgegeben, der darauf hinweist, dass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann.
PFAuthenticationLoginWithXboxIdRequest PFAuthenticationLoginWithXboxIdRequest-Datenmodell. Wenn sich ein Benutzer zum ersten Mal mit der Xbox-ID anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit dem Xbox Live-Konto verknüpft. In diesem Fall wird dem PlayFab-Konto keine E-Mail-Adresse oder kein Benutzername zugeordnet. Andernfalls wird ein Fehler zurückgegeben, wenn kein PlayFab-Konto mit dem Xbox Live-Konto verknüpft ist, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos leiten kann.
PFAuthenticationLoginWithXboxRequest PFAuthenticationLoginWithXboxRequest-Datenmodell. Wenn sich ein Benutzer zum ersten Mal mit dem Xbox Live-Konto anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit dem Xbox Live-Konto verknüpft. In diesem Fall wird dem PlayFab-Konto keine E-Mail-Adresse oder kein Benutzername zugeordnet. Andernfalls wird ein Fehler zurückgegeben, wenn kein PlayFab-Konto mit dem Xbox Live-Konto verknüpft ist, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos leiten kann.
PFAuthenticationLoginWithXUserRequest PFAuthenticationLoginWithXUserRequest-Datenmodell. Wenn sich ein Benutzer zum ersten Mal mit dem Xbox Live-Konto anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit dem Xbox Live-Konto verknüpft. In diesem Fall wird dem PlayFab-Konto keine E-Mail-Adresse oder kein Benutzername zugeordnet. Andernfalls wird ein Fehler zurückgegeben, wenn kein PlayFab-Konto mit dem Xbox Live-Konto verknüpft ist, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos leiten kann. Anforderungsobjekt für PFAuthenticationLoginWithXUserAsync.
PFAuthenticationServerLoginWithXboxRequest PFAuthenticationServerLoginWithXboxRequest-Datenmodell. Wenn sich ein Benutzer zum ersten Mal mit dem Xbox Live-Konto anmeldet und CreateAccount auf true festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit dem Xbox Live-Konto verknüpft. In diesem Fall wird dem PlayFab-Konto keine E-Mail-Adresse oder kein Benutzername zugeordnet. Andernfalls wird ein Fehler zurückgegeben, wenn kein PlayFab-Konto mit dem Xbox Live-Konto verknüpft ist, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos leiten kann.
PFAuthenticationUserSettings PFAuthenticationUserSettings-Datenmodell.
PFAuthenticationValidateEntityTokenRequest PFAuthenticationValidateEntityTokenRequest-Datenmodell. Mit einem Entitätstoken wird überprüft, ob es nicht abgelaufen ist oder widerrufen wurde, und gibt Details zum Besitzer zurück.
PFAuthenticationValidateEntityTokenResponse PFAuthenticationValidateEntityTokenResponse-Datenmodell.

Zustandsänderungen

Zustandsänderung Beschreibung

Enumerationen

Enumeration Beschreibung
PFAuthenticationIdentifiedDeviceType IdentifiedDeviceType-Enumeration.