Services C API-Übersicht – PFAuthenticationTypes.h

Strukturen

Struktur Beschreibung
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 keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Andernfalls, wenn kein PlayFab-Konto mit dem XBOX Live-Konto verknüpft ist, wird eine entsprechende Fehlermeldung zurückgegeben, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Anforderungsobjekt für PFAuthenticationLoginWithXUserAsync.
PFAuthenticationAuthenticateCustomIdRequest PFAuthenticationAuthenticateCustomIdRequest Datenmodell. Erstellen oder Zurückgeben eines game_server Entitätstokens. Der Anrufer 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. Der Header muss noch gültig sein und darf nicht abgelaufen oder widerrufen werden. Bei erfolgreicher Ausführung wird ein neues Entitätstoken ausgegeben und das PlayStream-Ereignis "entity_logged_in" ausgegeben.
PFAuthenticationLoginResult PFAuthenticationLoginResult-Datenmodell.
PFAuthenticationLoginWithAppleRequest PFAuthenticationLoginWithAppleRequest-Datenmodell.
PFAuthenticationLoginWithBattleNetRequest PFAuthenticationLoginWithBattleNetRequest-Datenmodell.
PFAuthenticationLoginWithCustomIDRequest PFAuthenticationLoginWithCustomIDRequest-Datenmodell. Es wird dringend empfohlen, dass Entwickler sicherstellen, dass es äußerst unwahrscheinlich ist, dass ein Kunde eine ID generieren kann, 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 keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Wenn kein PlayFab-Konto mit der benutzerdefinierten ID verknüpft ist, wird andernfalls ein entsprechender Fehler zurückgegeben, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann.
PFAuthenticationLoginWithFacebookRequest PFAuthenticationLoginWithFacebookRequest-Datenmodell. Die 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 keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Andernfalls, wenn kein PlayFab-Konto mit dem Facebook-Konto verknüpft ist, wird eine entsprechende Fehlermeldung zurückgegeben, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Beachten Sie, dass Titel niemals dieselben 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 wiederverwenden 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. Hinweis: Wenn der Benutzer mit AuthenticationToken anstelle von AccessToken authentifiziert wird, gibt die GetFriendsList-API eine leere Liste zurück.
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 den Gerätebezeichnern muss darauf geachtet werden, dass die Game Center-Kennung eines Spielers niemals Endbenutzern offengelegt 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 keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Wenn kein PlayFab-Konto mit dem Game Center-Konto verknüpft ist, wird andernfalls ein Fehler zurückgegeben, der dies angibt, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Wenn eine ungültige iOS-Game Center-Spieler-ID verwendet wird, wird ein Fehler zurückgegeben, der dies angibt.
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. Andernfalls wird ein entsprechender Fehler zurückgegeben, wenn kein PlayFab-Konto mit dem Google-Konto verknüpft ist, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Die aktuelle (empfohlene) Methode zum Abrufen von Google-Kontoanmeldeinformationen in einer Android-Anwendung besteht darin, GoogleSignInAccount.getServerAuthCode() aufzurufen und den Authentifizierungscode als ServerAuthCode-Parameter dieser API zu senden. Zuvor müssen Sie eine OAuth 2.0-Webanwendungsclient-ID in der Google API Console erstellen und deren Client-ID und Geheimnis im PlayFab Game Manager-Google-Add-on für Ihren Titel konfigurieren. Bei dieser Methode muss der Benutzer nicht für zusätzliche Google-Kontoberechtigungen aufgefordert werden, was zu einer Benutzererfahrung mit den geringstmöglichen Reibungsverlusten 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 PFAuthenticationLoginWithGooglePlayGamesServicesDatenmodell anfordern. Die Anmeldung bei Google Play Games 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 kein PlayFab-Konto mit dem Google Play Games-Konto verknüpft ist, wird andernfalls ein entsprechender Fehler zurückgegeben, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Die aktuelle (empfohlene) Methode zum Abrufen von Google Play Games-Kontoanmeldeinformationen in einer Android-Anwendung besteht darin, GamesSignInClient.requestServerSideAccess() aufzurufen und den Authentifizierungscode als ServerAuthCode-Parameter dieser API zu senden. Zuvor müssen Sie eine OAuth 2.0-Webanwendungsclient-ID in der Google API Console erstellen und deren Client-ID und Geheimnis im PlayFab Game Manager-Google-Add-on für Ihren Titel konfigurieren. Bei dieser Methode muss der Benutzer nicht für zusätzliche Google-Kontoberechtigungen aufgefordert werden, was zu einer Benutzererfahrung mit den geringstmöglichen Reibungsverlusten 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" gesetzt ist, wird ein neues PlayFab-Konto erstellt und mit dem PlayStation ™️ Network-Konto verknüpft. In diesem Fall wird keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Andernfalls, wenn kein PlayFab-Konto mit dem PlayStation ™️ Network-Konto verknüpft ist, wird eine entsprechende Fehlermeldung zurückgegeben, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen 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 keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Andernfalls wird ein entsprechender Fehler zurückgegeben, wenn kein PlayFab-Konto mit dem Steam-Konto verknüpft ist, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Bei Steam-Benutzern, die nicht bei der Steam-Client-App angemeldet sind, wird nur ihr Steam-Benutzername synchronisiert, 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-Marktplatz) konfiguriert werden. Sie können einen Web-API-Schlüssel von der Berechtigungsseite jeder 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 keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Andernfalls wird ein entsprechender Fehler zurückgegeben, wenn kein PlayFab-Konto mit dem Steam-Konto verknüpft ist, sodass 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 keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Wenn kein PlayFab-Konto mit dem Xbox Live-Konto verknüpft ist, wird eine entsprechende Fehlermeldung zurückgegeben, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen 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 keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Wenn kein PlayFab-Konto mit dem Xbox Live-Konto verknüpft ist, wird eine entsprechende Fehlermeldung zurückgegeben, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann.
PFAuthenticationServerLoginWithAndroidDeviceIDRequest PFAuthenticationServerLoginWithAndroidDeviceIDRequest-Datenmodell. Auf Android-Geräten wird empfohlen, die Settings.Secure.ANDROID_ID als AndroidDeviceId zu verwenden, wie in diesem Blogbeitrag beschrieben (http://android-developers.blogspot.com/2011/03/identifying-app-installations.html). Weitere Informationen zu diesem Bezeichner finden Sie in der Android-Dokumentation (http://developer.android.com/reference/android/provider/Settings.Secure.html). Wenn sich ein Benutzer zum ersten Mal mit dem Android-Gerät anmeldet und CreateAccount auf "true" festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit der Android-Geräte-ID verknüpft. In diesem Fall wird keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Andernfalls wird ein entsprechender Fehler zurückgegeben, wenn kein PlayFab-Konto mit dem Android-Gerät verknüpft ist, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann. Bitte beachten Sie, dass zwar mehrere Geräte dieses Typs mit einem einzigen Benutzerkonto verknüpft werden können, aber nur das Gerät in den Kontoinformationen des Benutzers angezeigt wird, mit dem Sie sich zuletzt angemeldet haben (oder zuletzt verknüpft wurden). Wir werden in einer zukünftigen Version aktualisieren, um alle verknüpften Geräte anzuzeigen.
PFAuthenticationServerLoginWithBattleNetRequest PFAuthenticationServerLoginWithBattleNetRequest-Datenmodell.
PFAuthenticationServerLoginWithCustomIDRequest PFAuthenticationServerLoginWithCustomIDRequest-Datenmodell. Es wird dringend empfohlen, dass Entwickler sicherstellen, dass es äußerst unwahrscheinlich ist, dass ein Kunde eine ID generieren kann, 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 keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Wenn kein PlayFab-Konto mit der benutzerdefinierten ID verknüpft ist, wird andernfalls ein entsprechender Fehler zurückgegeben, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann.
PFAuthenticationServerLoginWithIOSDeviceIDRequest PFAuthenticationServerLoginWithIOSDeviceIDRequest-Datenmodell. Auf iOS-Geräten muss identifierForVendor (https://developer.apple.com/library/ios/documentation/UIKit/Reference/UIDevice_Class/index.html# // apple_ref/occ/instp/UIDevice/identifierForVendor) als Geräte-ID verwendet werden, da der UIDevice uniqueIdentifier ab iOS 5 veraltet ist und die Verwendung des advertisingIdentifier zu diesem Zweck zum Fehlschlagen des Zertifizierungsprozesses von Apple führt. Wenn sich ein Benutzer zum ersten Mal mit dem iOS-Gerät anmeldet und CreateAccount auf "true" festgelegt ist, wird ein neues PlayFab-Konto erstellt und mit der herstellerspezifischen iOS-Geräte-ID verknüpft. In diesem Fall wird keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Andernfalls, wenn kein PlayFab-Konto mit dem iOS-Gerät verknüpft ist, wird ein entsprechender Fehler zurückgegeben, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann.
PFAuthenticationServerLoginWithPSNRequest PFAuthenticationServerLoginWithPSNRequest-Datenmodell. Wenn sich ein Benutzer zum ersten Mal mit dem PlayStation ™️ Network-Konto anmeldet und CreateAccount auf "true" gesetzt ist, wird ein neues PlayFab-Konto erstellt und mit dem PlayStation ™️ Network-Konto verknüpft. In diesem Fall wird keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Andernfalls, wenn kein PlayFab-Konto mit dem PlayStation ™️ Network-Konto verknüpft ist, wird eine entsprechende Fehlermeldung zurückgegeben, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann.
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 keine E-Mail-Adresse oder kein Benutzername mit dem PlayFab-Konto verknüpft. Wenn kein PlayFab-Konto mit dem Xbox Live-Konto verknüpft ist, wird eine entsprechende Fehlermeldung zurückgegeben, sodass der Titel den Benutzer durch die Erstellung eines PlayFab-Kontos führen kann.
PFAuthenticationUserSettings PFAuthenticationUserSettings-Datenmodell.
PFAuthenticationValidateEntityTokenRequest PFAuthenticationValidateEntityTokenRequest Datenmodell. Wenn ein Entitätstoken angegeben wird, wird überprüft, ob es abgelaufen oder widerrufen wurde, und gibt die Details des Besitzers zurück.
PFAuthenticationValidateEntityTokenResponse PFAuthenticationValidateEntityTokenResponse-Datenmodell.

Statusänderungen

Statusänderung Beschreibung

Enumerationen

Aufzählung Beschreibung
PFAuthenticationIdentifiedDeviceType IdentifiedDeviceType-Enumeration.
  • Zuletzt aktualisiert um