PartyManager::Initialize

Initialisiert die PartyManager-Objektinstanz.

Syntax

PartyError Initialize(  
    PartyString titleId  
)  

Parameter

titleId PartyString

Die PlayFab-Titel-ID der App.

Rückgabewert

PartyError

c_partyErrorSuccess , wenn der Aufruf erfolgreich war oder andernfalls ein Fehlercode vorliegt. 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 ohne einen nachfolgenden Cleanup() -Aufruf nicht erneut aufgerufen werden.

Jeder Aufruf von Initialize() sollte über einen entsprechenden Cleanup()-Aufruf verfügen.

Apps, die die Microsoft Game Core-Version der Partybibliothek verwenden, müssen warten, bis der Game Core-Netzwerkstapel initialisiert wurde, bevor diese Methode aufgerufen wird. Der Status des Netzwerkstapels kann mithilfe der Game Core XNetworkingGetConnectivityHint-API ermittelt werden.

Apps, die die Microsoft Game Core-Version der Partybibliothek 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 Partybibliothek erneut initialisieren, indem PartyManager::Initialize() aufgerufen wird.

Die angegebene titleId muss dieselbe Titel-ID sein, die zum Abrufen der PlayFab-Entitäts-IDs und Entitätstoken verwendet wird, die an CreateLocalUser(), CreateLocalUserWithEntityType() und PartyLocalUser::UpdateEntityToken()übergeben werden.

Anforderungen

Kopfball: 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