構文
パラメーター
handle PFMultiplayerHandle
PFMultiplayer API インスタンスのハンドル。
entity PFEntityKey*
トークンと関連付ける PlayFab エンティティ キー。
entityToken char*is null-terminated TBD
戻り値
型: HRESULT ローカル ユーザーの作成に成功した場合はS_OK、それ以外の場合はエラー コード。エラー コードの人間が読める形式は PFMultiplayerGetErrorMessage() を通じて取得できます。
注釈
このメソッドは PlayFab エンティティ キーをentity として、PlayFab エンティティ トークンを token として受け取ります。ライブラリが、ロビーの作成や更新など、認証や認可が必要なエンティティに代わる操作を実行する際、その操作に使用するトークンをエンティティに関連付けられているものから検索します。エンティティに対して以前にトークンが設定されていない場合、その操作は同期的に失敗します。非同期操作の実行中に、PlayFab サービスはトークンが有効であること、有効期限切れでないこと、指定されたエンティティ ID に関連付けられていること、およびその操作を実行する権限があることを検証します。これらの条件が満たされない場合、操作は失敗します。PlayFab エンティティ キーとエンティティ トークンは、PlayFab のログイン操作の出力から取得し、このメソッドの入力として提供できます。
指定する
entity と token は、PFMultiplayerInitialize() に渡したものと同じ PlayFab タイトル ID を使用して取得されている必要があります。 Multiplayer ライブラリは、提供された PlayFab エンティティ トークンのコピーを保持し、
PFMultiplayerCreateAndJoinLobby のようにローカル ユーザーの認証や認可を必要とするその後の操作に使用します。この呼び出しで提供されたトークンが有効期限切れ、またはその他の理由で無効な場合、有効なトークンが必要な操作は失敗します。同じエンティティ キーを使ってこのメソッドを再度呼び出すことで、新しい有効なトークンを Multiplayer ライブラリに提供できます。 このメソッドに提供したエンティティ トークンの有効期限を監視するのは呼び出し元の責任です。トークンが有効期限に近づいた、または過ぎた場合は、PlayFab のログイン操作を実行して新しいトークンを取得し、このメソッドを再度呼び出して Multiplayer ライブラリに提供する必要があります。以前に提供したトークンが有効期間の半分を経過した時点で新しいトークンを取得することが推奨されます。低電力状態に入る可能性があるプラットフォーム、またはその他の理由でアプリケーションの実行が長時間停止し、トークンが失効前に更新できない場合には、実行が再開された時点でトークンの有効期限をチェックする必要があります。
これらの値に対して同期的な検証は行われません。
要件
ヘッダー: PFMultiplayer.h関連項目
PFMultiplayer メンバーPFMultiplayerInitialize