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