PFMultiplayerInitialize

Artikel
07/11/2023

Initialisiert eine instance der PlayFab Multiplayer-Bibliothek.

Syntax

HRESULT PFMultiplayerInitialize(  
    const char* playFabTitleId,  
    PFMultiplayerHandle* handle  
)

Parameter

playFabTitleId Char*
ist NULL-terminiert.

Die PlayFab-Titel-ID der App.

handle PFMultiplayerHandle*
Bibliotheksseitig zugeordnete Ausgabe

Das Ausgabehandle der neu initialisierten PFMultiplayer-API instance.

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

Dies muss vor jeder anderen Methode aufgerufen werden, abgesehen von PFMultiplayerSetMemoryCallbacks() und PFMultiplayerSetThreadAffinityMask(). PFMultiplayerInitialize() kann ohne einen nachfolgenden PFMultiplayerUninitialize() -Aufruf nicht erneut aufgerufen werden.

Jeder Aufruf von PFMultiplayerInitialize() sollte über einen entsprechenden PFMultiplayerUninitialize()-Aufruf verfügen.

Apps, die die Microsoft Game Core-Version der Multiplayer-Bibliothek verwenden, müssen warten, bis der Game Core-Netzwerkstapel initialisiert wurde, bevor diese Methode aufgerufen wird. Das Bestimmen der status des Netzwerkstapels kann mithilfe der Game Core XNetworkingGetConnectivityHint-API erfolgen.

Die angegebene playFabTitleId muss dieselbe PlayFab-Titel-ID sein, die zum Abrufen der PlayFab-Entitätsschlüssel und Entitätstoken verwendet wird, die an PFMultiplayerSetEntityToken()übergeben werden.

Voraussetzungen

Header: PFMultiplayer.h

Weitere Informationen

PFMultiplayer-Member
PFMultiplayerSetEntityToken
PFMultiplayerUninitialize
PFMultiplayerSetMemoryCallbacks
PFMultiplayerSetThreadAffinityMask

Freigeben über