サービス C API の概要 - PFAuthenticationTypes.h

構造体

構造体 説明
PFAuthenticationAuthenticateCustomIdRequest PFAuthenticationAuthenticateCustomIdRequest データ モデル。 game_server エンティティ トークンを作成または返します。 呼び出し元はタイトル エンティティである必要があります。
PFAuthenticationAuthenticateCustomIdResult PFAuthenticationAuthenticateCustomIdResult データ モデル。
PFAuthenticationDeleteRequest PFAuthenticationDeleteRequest データ モデル。 game_server エンティティを削除します。 呼び出し元は、自身を削除しようとしている game_server エンティティである可能性があります。 または、このタイトルの game_server エンティティを削除しようとしているタイトル エンティティ。
PFAuthenticationEntityTokenResponse PFAuthenticationEntityTokenResponse データ モデル。
PFAuthenticationGetEntityRequest PFAuthenticationGetEntityRequest データ モデル。 この API は、X-SecretKey、X-Authentication、または X-EntityToken ヘッダーで呼び出す必要があります。 オプションの EntityKey を含めて、結果の EntityToken を特定のエンティティに設定することもできますが、そのエンティティは、キャラクターの master_player_account など、呼び出し元の関係である必要があります。 X-EntityToken を送信すると、アカウントは新しくログインしたものとしてマークされ、新しいトークンが発行されます。 X-Authentication または X-EntityToken を使用する場合、ヘッダーはまだ有効である必要があり、期限切れにしたり取り消したりすることはできません。
PFAuthenticationLoginResult PFAuthenticationLoginResult データ モデル。
PFAuthenticationLoginWithAppleRequest PFAuthenticationLoginWithAppleRequest データ モデル。
PFAuthenticationLoginWithCustomIDRequest PFAuthenticationLoginWithCustomIDRequest データ モデル。 顧客が生成する ID が、既に別の顧客が使用している ID と同じになる可能性を極力低くすることが、開発者には強く求められます。 ユーザーがカスタム ID で初めてサインインし、CreateAccount が true に設定されている場合、新しい PlayFab アカウントが作成され、カスタム ID にリンクされます。 この場合、メールアドレスとユーザー名は PlayFab アカウントに関連付けられません。 それ以外の場合で、PlayFab アカウントが カスタム ID にリンクされていない場合は、これを示すエラーが返され、タイトルがユーザーに対して PlayFab アカウントの作成をガイドできるようになります。
PFAuthenticationLoginWithFacebookRequest PFAuthenticationLoginWithPfRequest データ モデル。 Facebook サインインは、Facebook ユーザー アクセス トークンを使用して行われます。 トークンの詳細については、Facebook 開発者向けドキュメント (https://developers.facebook.com/docs/facebook-login/access-tokens/) を参照してください。 たとえば Unity では、トークンは Facebook SDK ScriptableObject FB で AccessToken として使用できます。 ユーザーが Facebook アカウントを使用して初めてサインインし、CreateAccount が true に設定されている場合、新しい PlayFab アカウントが作成され、指定されたアカウントの Facebook ID にリンクされます。 この場合、メールアドレスとユーザー名は PlayFab アカウントに関連付けられません。 それ以外の場合で、PlayFab アカウントが Facebook アカウントにリンクされていない場合は、これを示すエラーが返され、タイトルがユーザーに対して PlayFab アカウントの作成をガイドできるようになります。 タイトルは PlayFab タイトル ID 間で同じ Facebook アプリケーションを再利用しないでください。Facebook はアプリケーションごとに一意のユーザー ID を提供するため、その結果、PlayFab アカウント情報内のユーザーの Facebook ID に問題が発生する可能性があります。 新しい PlayFab タイトル ID でアプリケーションを再利用する必要がある場合は、まず Facebook からすべてのアカウントのリンクを解除するか、最初のタイトル ID のすべてのユーザーを削除してください。
PFAuthenticationLoginWithGameCenterRequest PFAuthenticationLoginWithGameCenterRequest データ モデル。 Game Center プレイヤー識別子 (https://developer.apple.com/library/ios/documentation/Accounts/Reference/ACAccountClassRef/index.html# // apple_ref/occ/instp/ACAccount/identifier) は、ローカル デバイスに格納される生成された文字列です。 デバイス識別子と同様に、ユーザーのアカウントが侵害される可能性があるため、プレイヤーの Game Center 識別子をエンド ユーザーに決して公開しないように注意する必要があります。 ユーザーが Game Center に初めてサインインし、CreateAccount が true に設定されている場合、新しい PlayFab アカウントが作成され、Game Center 識別子にリンクされます。 この場合、メールアドレスとユーザー名は PlayFab アカウントに関連付けられません。 それ以外の場合で、Game Center アカウントが Steam アカウントにリンクされていない場合は、これを示すエラーが返され、タイトルがユーザーに対して PlayFab アカウントの作成をガイドできるようになります。 無効な iOS Game Center プレイヤー識別子が使用されている場合は、これが返されることを示すエラーが返されます。
PFAuthenticationLoginWithGoogleAccountRequest PFAuthenticationLoginWithPfAccountRequest データ モデル。 Google サインインは、デバイス上の Android API 用 Google サインインを使用して Google OAuth 2.0 資格情報を取得し、この API に渡すことによって実現されます。 ユーザーが Google アカウントを使用して初めてサインインし、CreateAccount が true に設定されている場合、新しい PlayFab アカウントが作成され、Google アカウントにリンクされます。 それ以外の場合で、PlayFab アカウントが Google アカウントにリンクされていない場合は、これを示すエラーが返され、タイトルがユーザーに対して PlayFab アカウントの作成をガイドできるようになります。 Android アプリケーションで Google アカウント資格情報を取得するための現在の (推奨) 方法は、GoogleSignInAccount.getServerAuthCode() を呼び出し、認証コードをこの API の ServerAuthCode パラメーターとして送信することです。 これを行う前に、Google API コンソールで OAuth 2.0 Web アプリケーション クライアント ID を作成し、タイトルの PlayFab Game Manager Google アドオンでそのクライアント ID とシークレットを構成する必要があります。 この方法では、追加の Google アカウントのアクセス許可をユーザーに求める必要がないため、ユーザー エクスペリエンスは最小限に抑えられます。 サーバー認証コードの取得の詳細については、https://developers.google.com/identity/sign-in/android/offline-access を参照してください。 以前の (非推奨の) メソッドは、クライアントで GetAccessToken() を呼び出し、AccessToken パラメーターとしてこの API に渡すことによって、OAuth アクセス トークンを取得することでした。 Google OAuth 2.0 アクセス トークンを使用する場合。 この変更の詳細については、Google 開発者向けドキュメント (https://android-developers.googleblog.com/2016/01/play-games-permissions-are-changing-in.html) を参照してください。
PFAuthenticationLoginWithGooglePlayGamesServicesRequest PFAuthenticationLoginWithWebPlayGamesServicesRequest データ モデル。 Google Play Games サインインは、デバイス上の Android API 用 Google Play Games サインインを使用して Google OAuth 2.0 資格情報を取得し、この API に渡すことによって実現されます。 ユーザーが Google Play Games アカウントを使用して初めてサインインし、CreateAccount が true に設定されている場合、新しい PlayFab アカウントが作成され、Google Play Games アカウントにリンクされます。 それ以外の場合で、PlayFab アカウントが Google Play Games アカウントにリンクされていない場合は、これを示すエラーが返され、タイトルがユーザーに対して PlayFab アカウントの作成をガイドできるようになります。 Android アプリケーションで Google Play Games アカウント資格情報を取得するための現在の (推奨) 方法は、GamesSignInClient.requestServerSideAccess() を呼び出し、認証コードをこの API の ServerAuthCode パラメーターとして送信することです。 これを行う前に、Google API コンソールで OAuth 2.0 Web アプリケーション クライアント ID を作成し、タイトルの PlayFab Game Manager Google アドオンでそのクライアント ID とシークレットを構成する必要があります。 この方法では、追加の Google アカウントのアクセス許可をユーザーに求める必要がないため、ユーザー エクスペリエンスは最小限に抑えられます。 サーバー認証コードの取得の詳細については、https://developers.google.com/games/services/android/signin を参照してください。
PFAuthenticationLoginWithNintendoServiceAccountRequest PFAuthenticationLoginWithNintendoServiceAccountRequest データ モデル。
PFAuthenticationLoginWithOpenIdConnectRequest PFAuthenticationLoginWithOpenIdConnectRequest データ モデル。
PFAuthenticationLoginWithPSNRequest PFAuthenticationLoginWithPSNRequest データ モデル。 ユーザーが PlayStation ™️ Network アカウントを使用して初めてサインインし、CreateAccount が True に設定されている場合、新しい PlayFab アカウントが作成され、PlayStation ™️ Network アカウントにリンクされます。 この場合、メールアドレスとユーザー名は PlayFab アカウントに関連付けられません。 それ以外の場合で、PlayFab アカウントが PlayStation ™️ Network アカウントにリンクされていない場合は、これを示すエラーが返され、タイトルがユーザーに対して PlayFab アカウントの作成をガイドできるようになります。
PFAuthenticationLoginWithServerCustomIdRequest PFAuthenticationLoginWithServerCustomIdRequest データ モデル。
PFAuthenticationLoginWithSteamIdRequest PFAuthenticationLoginWithSteamIdRequest データ モデル。 ユーザーが Steam ID で初めてサインインし、CreateAccount が true に設定されている場合、新しい PlayFab アカウントが作成され、Steam アカウントにリンクされます。 この場合、メールアドレスとユーザー名は PlayFab アカウントに関連付けられません。 それ以外の場合で、PlayFab アカウントが Steam アカウントにリンクされていない場合は、これを示すエラーが返され、タイトルがユーザーに対して PlayFab アカウントの作成をガイドできるようになります。 Steam クライアント アプリにログインしていない Steam ユーザーは、Steam ユーザー名のみが同期され、通貨や国などの他のデータは、クライアントが開いている間にログインするまで利用できません。
PFAuthenticationLoginWithSteamRequest PFAuthenticationLoginWithSteamRequest データ モデル。 Steam サインインは、Steam セッション チケットを使用して実行されます。 チケットの詳細については、Steamworks SDK (https://partner.steamgames.com/documentation/auth) を参照してください。注: Steam 認証が機能するには、PlayFab ゲーム マネージャー (アドオン マーケットプレイスの Steam の下) で Steam アプリケーション ID と Web API キーを使用してタイトルを構成する必要があります。 Web API キーは、Steamworks サイトのアプリ ID に関連付けられている任意のグループの [アクセス許可] ページから取得できます。 ユーザーが Steam アカウントを使用して初めてサインインし、CreateAccount が true に設定されている場合、新しい PlayFab アカウントが作成され、指定されたアカウントの Steam ID にリンクされます。 この場合、メールアドレスとユーザー名は PlayFab アカウントに関連付けられません。 それ以外の場合で、PlayFab アカウントが Steam アカウントにリンクされていない場合は、これを示すエラーが返され、タイトルがユーザーに対して PlayFab アカウントの作成をガイドできるようになります。
PFAuthenticationLoginWithXboxIdRequest PFAuthenticationLoginWithXboxIdRequest データ モデル。 ユーザーが Xbox ID を使用して初めてサインインし、CreateAccount が true に設定されている場合、新しい PlayFab アカウントが作成され、Xbox Live アカウントにリンクされます。 この場合、メールアドレスとユーザー名は PlayFab アカウントに関連付けられません。 それ以外の場合、PlayFab アカウントが Xbox Live アカウントにリンクされていない場合は、これを示すエラーが返され、タイトルによってユーザーが PlayFab アカウントの作成をガイドできるようになります。
PFAuthenticationLoginWithXboxRequest PFAuthenticationLoginWithXboxRequest データ モデル。 ユーザーが Xbox Live アカウントを使用して初めてサインインし、CreateAccount が true に設定されている場合、新しい PlayFab アカウントが作成され、Xbox Live アカウントにリンクされます。 この場合、メールアドレスとユーザー名は PlayFab アカウントに関連付けられません。 それ以外の場合で、PlayFab アカウントが Xbox Live アカウントにリンクされていない場合は、これを示すエラーが返され、タイトルがユーザーに対して PlayFab アカウントの作成をガイドできるようになります。
PFAuthenticationLoginWithXUserRequest PFAuthenticationLoginWithXUserRequest データ モデル。 ユーザーが Xbox Live アカウントを使用して初めてサインインし、CreateAccount が true に設定されている場合、新しい PlayFab アカウントが作成され、Xbox Live アカウントにリンクされます。 この場合、メールアドレスとユーザー名は PlayFab アカウントに関連付けられません。 それ以外の場合、PlayFab アカウントが Xbox Live アカウントにリンクされていない場合は、これを示すエラーが返され、タイトルによってユーザーが PlayFab アカウントの作成をガイドできるようになります。 PFAuthenticationLoginWithXUserAsync の要求オブジェクト。
PFAuthenticationServerLoginWithXboxRequest PFAuthenticationServerLoginWithXboxRequest データ モデル。 ユーザーが Xbox Live アカウントを使用して初めてサインインし、CreateAccount が true に設定されている場合、新しい PlayFab アカウントが作成され、Xbox Live アカウントにリンクされます。 この場合、メールアドレスとユーザー名は PlayFab アカウントに関連付けられません。 それ以外の場合、PlayFab アカウントが Xbox Live アカウントにリンクされていない場合は、これを示すエラーが返され、タイトルによってユーザーが PlayFab アカウントの作成をガイドできるようになります。
PFAuthenticationUserSettings PFAuthenticationUserSettings データ モデル。
PFAuthenticationValidateEntityTokenRequest PFAuthenticationValidateEntityTokenRequest データ モデル。 エンティティ トークンを指定すると、有効期限が切れていないか取り消されていないことを検証し、所有者の詳細を返します。
PFAuthenticationValidateEntityTokenResponse PFAuthenticationValidateEntityTokenResponse データ モデル。

状態の変更

状態の変更 説明

列挙

列挙型 説明
PFAuthenticationIdentifiedDeviceType IdentifiedDeviceType 列挙型。