Freigeben über


PFLobbyGetMemberConnectionStatus

Bestimmt die Verbindung eines Mitglieds status mit dem Benachrichtigungsdienst.

Syntax

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

Parameter

lobby PFLobbyHandle

Der Griff des Wartebereichs.

member PFEntityKey*

Der Member, dessen Verbindung status überprüft wird.

connectionStatus PFLobbyMemberConnectionStatus*
Ausgabe

Die Ausgabeverbindung status des Members.

Rückgabewert

Typ: HRESULT

S_OK , wenn der Aufruf erfolgreich war oder andernfalls ein Fehlercode vorliegt. Die lesbare Form des Fehlercodes kann über PFMultiplayerGetErrorMessage() abgerufen werden.

Hinweise

Beim Beitritt zu einem Wartebereich stellt die Bibliothek eine WebSocket-Verbindung mit dem PlayFab PubSub-Benachrichtigungsdienst her. Diese Verbindung wird verwendet, um Echtzeitupdates für die Bibliothek über den Wartebereich bereitzustellen. Diese Methode kann verwendet werden, um die Verbindung eines Mitglieds status zu bestimmen. Dies ist nützlich, um die Fähigkeit eines Mitglieds zu diagnostizieren, Updates zum Wartebereich zu erhalten.

Ein lokales Mitglied, das noch dabei ist, dem Wartebereich asynchron über einen Aufruf von PFMultiplayerCreateAndJoinLobby(), PFMultiplayerJoinLobby() oder PFLobbyAddMember beizutreten, wird seine Verbindung status als PFLobbyMemberConnectionStatus::NotConnected angezeigt, bis die Verbindung hergestellt wurde.

Wenn sich die Verbindung eines Benutzers status ändert, wird ein PFLobbyMemberUpdateSummary für den Titel bereitgestellt, wobei das PFLobbyMemberUpdateSummary::member Feld auf den Entitätsschlüssel des Benutzers und das PFLobbyMemberUpdateSummary::connectionStatusUpdated Feld auf true festgelegt ist. Der PFLobbyMemberUpdateSummary wird dem Titel als Eintrag für memberUpdates eine PFLobbyUpdatedStateChange-Struktur über PFMultiplayerStartProcessingLobbyStateChanges()bereitgestellt.

Wenn sich die Verbindung eines Benutzers status von PFLobbyMemberConnectionStatus::Connected zu PFLobbyMemberConnectionStatus::NotConnected ändert, treten möglicherweise Konnektivitätsprobleme auf, oder sein Spiel ist möglicherweise abgestürzt. Der Lobbybesitzer kann solche Benutzer über PFLobbyForceRemoveMember() aus dem Wartebereich entfernen.

Voraussetzungen

Header: PFLobby.h

Weitere Informationen

PFLobby-Member