跳轉到主要內容
判斷成員與通知服務的連線狀態。

語法

參數

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() 將這類使用者從大廳中移除。

需求

標頭: PFLobby.h

另請參閱

PFLobby 成員
最後修改於 2026年10月8日