PFLobbyGetMemberConnectionStatus
确定成员与通知服务的连接状态。
语法
HRESULT PFLobbyGetMemberConnectionStatus(
PFLobbyHandle lobby,
const PFEntityKey* member,
PFLobbyMemberConnectionStatus* connectionStatus
)
参数
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