構文
パラメーター
entityToken PartyString
ローカル ユーザーに関連付ける新しい PlayFab エンティティ トークン。
戻り値
PartyError 呼び出しが成功した場合はc_partyErrorSuccess、それ以外の場合はエラー コード。エラー コードの人間が判読可能な形式は、PartyManager::GetErrorMessage() から取得できます。
解説
このメソッドはentityToken として PlayFab エンティティ トークンを受け取ります。この値に対して同期的な検証は行われません。ライブラリが、ネットワークの作成、ネットワークへの認証、音声テキスト変換の実行など、ユーザー認証または承認が必要な操作を行うと、Party サービスは、トークンが有効であり、有効期限が切れておらず、PartyManager::CreateLocalUser() または PartyManager::CreateLocalUserWithEntityType() 呼び出しに提供されたエンティティ ID と同じものに関連付けられており、その操作の実行を承認されていることを検証します。これらの条件が満たされていない場合、操作は失敗します。PlayFab エンティティ トークンは PlayFab ログイン操作の出力から取得でき、このメソッドへの入力として提供できます。トークンは、PartyManager::CreateLocalUser() または PartyManager::CreateLocalUserWithEntityType() で最初に指定されたものと同じ PlayFab エンティティ ID とタイプに関連付けられている必要があります。
提供される
entityToken は、PartyManager::Initialize() に渡されたのと同じ Title ID を使用して取得されている必要があります。 Party ライブラリは、PartyManager::CreateNewNetwork() や PartyNetwork::AuthenticateLocalUser() のように、ローカル ユーザーの認証や承認が必要な後続の操作で使用するために、提供された PlayFab エンティティ トークンのコピーを作成します。この呼び出しに提供されたトークンが有効期限切れであるか、それ以外の場合に無効な場合、有効なトークンが必要な操作は失敗します。このメソッドを再度呼び出すことで、新しい有効なトークンを Party ライブラリに提供できます。
このメソッドと PartyManager::CreateLocalUser() または PartyManager::CreateLocalUserWithEntityType() に提供されるエンティティ トークンの有効期限を監視するのは呼び出し元の責任です。トークンが有効期限に近づいているか、有効期限を過ぎた場合、PlayFab ログイン操作を実行して新しいトークンを取得し、このメソッドを呼び出して Party ライブラリに提供する必要があります。以前に提供したトークンが有効期間の半分に達したときに、新しいトークンを取得することをお勧めします。低電力状態に入る可能性があるプラットフォームや、アプリケーションが長時間実行を一時停止する可能性のあるプラットフォームでは、トークンの更新が期限切れになる前にできなくなる可能性があるため、実行が再開されたときにトークンの有効期限を確認する必要があります。
要件
ヘッダー: Party.h関連項目
PartyLocalUserPartyManager::GetErrorMessage
PartyManager::CreateLocalUser
PartyManager::CreateLocalUserWithEntityType
PartyManager::CreateNewNetwork
PartyNetwork::AuthenticateLocalUser