PFLobbyGetMemberConnectionStatus

确定成员与通知服务的连接状态。

语法

HRESULT PFLobbyGetMemberConnectionStatus(  
    PFLobbyHandle lobby,  
    const PFEntityKey* member,  
    PFLobbyMemberConnectionStatus* connectionStatus  
)  

参数

lobby PFLobbyHandle

大厅的句柄。

memberPFEntityKey*

将检查其连接状态的成员。

connectionStatusPFLobbyMemberConnectionStatus*
输出:

成员的输出连接状态。

返回值

类型: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 成员