PFLobbyGetMemberConnectionStatus
通知サービスへのメンバーの接続状態を決定します。
構文
HRESULT PFLobbyGetMemberConnectionStatus(
PFLobbyHandle lobby,
const PFEntityKey* member,
PFLobbyMemberConnectionStatus* connectionStatus
)
パラメーター
lobby PFLobbyHandle
ロビーのハンドル。
member
PFEntityKey*
接続状態が検査されるメンバー。
connectionStatus
PFLobbyMemberConnectionStatus*
出力
メンバーの出力接続状態。
戻り値
型: HRESULT
呼び出しが成功した場合は S_OK、それ以外の場合はエラー コードになります。 人間が読める形式のエラー コードは、PartyManager::GetErrorMessage() を介して取得できます。
解説
ロビーに参加すると、ライブラリは PlayFab PubSub 通知サービスへの WebSocket 接続を確立します。 この接続は、ロビーに関するリアルタイム更新をライブラリに提供するために使用されます。 このメソッドを使用して、メンバーの接続状態を判断できます。これは、ロビーに関する更新プログラムを受信するメンバーの能力を診断するのに役立ちます。
PFMultiplayerCreateAndJoinLobby()、PFMultiplayerJoinLobby()、または PFLobbyAddMember のいずれかの呼び出しを介してロビーに非同期参加中のローカル メンバーは、接続が確立されるまで、その接続状態が PFLobbyMemberConnectionStatus::NotConnected として表示されます。
ユーザーの接続状態が変更されると、PFLobbyMemberUpdateSummary がタイトルに提供され、PFLobbyMemberUpdateSummary::member フィールドはユーザーのエンティティ キーに設定され、PFLobbyMemberUpdateSummary::connectionStatusUpdated フィールドは true に設定されます。
PFLobbyMemberUpdateSummary は、PFMultiplayerStartProcessingLobbyStateChanges() を介して、PFLobbyUpdatedStateChange 構造体の memberUpdates エントリとしてタイトルに提供されます。
ユーザーの接続状態が PFLobbyMemberConnectionStatus::Connected から PFLobbyMemberConnectionStatus::NotConnected に変わると、接続の問題が発生しているか、ゲームがクラッシュしている可能性があります。 ロビーの所有者は、PFLobbyForceRemoveMember() を介してそうしたユーザーをロビーから削除できます。
要件
ヘッダー: PFLobby.h