構文
パラメーター
lobby PFLobbyHandle
ロビーのハンドル。
member PFEntityKey*
接続状態を調べるメンバー。
connectionStatus PFLobbyMemberConnectionStatus*出力 メンバーの接続状態の出力。
戻り値
型: HRESULT 呼び出しが成功した場合はS_OK、それ以外の場合はエラー コード。エラー コードの人間が判読可能な形式は、PFMultiplayerGetErrorMessage() を通じて取得できます。
解説
ロビーに参加すると、ライブラリは PlayFab PubSub 通知サービスへの WebSocket 接続を確立します。この接続は、ロビーに関するリアルタイム更新をライブラリに提供するために使用されます。このメソッドを使ってメンバーの接続状態を判定でき、そのメンバーがロビーに関する更新を受信できる状態にあるかを診断するのに役立ちます。PFMultiplayerCreateAndJoinLobby()、PFMultiplayerJoinLobby()、または PFLobbyAddMember の呼び出しにより、まだロビーへ非同期に参加処理中のローカル メンバーについては、接続が確立するまで接続状態は PFLobbyMemberConnectionStatus::NotConnected として表示されます。
ユーザーの接続状態が変化すると、PFLobbyMemberUpdateSummary がタイトルへ提供され、
PFLobbyMemberUpdateSummary::member フィールドにそのユーザーのエンティティ キーが設定され、PFLobbyMemberUpdateSummary::connectionStatusUpdated フィールドが true に設定されます。この PFLobbyMemberUpdateSummary は、PFMultiplayerStartProcessingLobbyStateChanges() 経由で PFLobbyUpdatedStateChange 構造体の memberUpdates エントリとしてタイトルに提供されます。ユーザーの接続状態が PFLobbyMemberConnectionStatus::Connected から PFLobbyMemberConnectionStatus::NotConnected に変化した場合、そのユーザーは接続の問題を抱えているか、ゲームがクラッシュした可能性があります。ロビー オーナーは、PFLobbyForceRemoveMember() を使用してそうしたユーザーをロビーから削除できます。