PartyManager::Initialize

Initialisiert die PartyManager-Objekt-instance.

Syntax

PartyError Initialize(  
    PartyString titleId  
)  

Parameter

titleId PartyString

Die PlayFab-Titel-ID der App.

Rückgabewert

PartyError

c_partyErrorSuccess Ob der Aufruf erfolgreich war oder ein Fehlercode andernfalls. Die lesbare Form des Fehlercodes kann über GetErrorMessage() abgerufen werden.

Hinweise

Dies muss vor jeder anderen Methode aufgerufen werden, abgesehen von den statischen Methoden GetSingleton(), SetMemoryCallbacks(), GetMemoryCallbacks(), SetThreadAffinityMask(), GetThreadAffinityMask(), SerializeNetworkDescriptor(), DeserializeNetworkDescriptor(), SetWorkMode() und GetWorkMode(). Initialize() kann nicht erneut aufgerufen werden, ohne einen nachfolgenden Cleanup( )-Aufruf durchzuführen.

Jeder Aufruf von Initialize() sollte einen entsprechenden Cleanup()-Aufruf haben.

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

Apps, die die Microsoft Game Core-Version der Party-Bibliothek verwenden, müssen über die RegisterAppStateChangeNotification-API auf App-Statusbenachrichtigungen lauschen. Wenn die App angehalten wird, muss die App PartyManager::Cleanup() aufrufen. Wenn die App fortgesetzt wird, muss der Titel warten, bis der Game Core-Netzwerkstapel bereit ist, und dann die Party-Bibliothek neu initialisieren, indem PartyManager::Initialize() aufgerufen wird.

Apps, die auf der Android-Plattform erstellt werden, müssen sicherstellen, dass BLUETOOTH_CONNECT im App-Manifest vorhanden ist, damit die Vertragspartei verfügbare Bluetooth-Geräte überwachen und eine Verbindung mit diesen herstellen kann.

Bei der angegebenen titleId muss es sich um dieselbe Titel-ID handeln, die zum Abrufen der PlayFab-Entitäts-IDs und Entitätstoken verwendet wird, die an CreateLocalUser(), CreateLocalUserWithEntityType() und PartyLocalUser::UpdateEntityToken() übergeben werden.

Anforderungen

Kopfzeile: Party.h

Weitere Informationen

PartyManager
PartyManager::CreateLocalUser
PartyManager::CreateLocalUserWithEntityType
PartyManager::Cleanup
PartyManager::GetSingleton
PartyManager::SetMemoryCallbacks
PartyManager::GetMemoryCallbacks
PartyManager::SetThreadAffinityMask
PartyManager::GetThreadAffinityMask
PartyManager::SerializeNetworkDescriptor
PartyManager::D eserializeNetworkDescriptor
PartyLocalUser::UpdateEntityToken