PartyManager::Initialize

初始化 PartyManager 对象实例。

语法

PartyError Initialize(  
    PartyString titleId  
)  

参数

titleIdPartyString

应用的 PlayFab 游戏 ID。

返回值

PartyError

如果调用成功,则为 c_partyErrorSuccess,否则为错误代码。 可通过 GetErrorMessage() 检索错误代码的可读形式。

备注

必须在任何其他方法之前调用此方法, 除了 GetSingleton()SetMemoryCallbacks()GetMemoryCallbacks()SetThreadAffinityMask()GetThreadAffinityMask()SerializeNetworkDescriptor()DeserializeNetworkDescriptor()SetWorkMode()GetWorkMode()。 如果没有后续的 Cleanup() 调用,就无法再次调用 Initialize()。

每次调用 Initialize() 都应该调用相应的 Cleanup()。

建议使用Xbox One XDK版本的 Party 库的应用等待平台准备好进行网络操作,然后再调用此方法。 有关详细信息,请参阅有关网络和安全设备关联最佳做法的 XDK 文档。

使用 Party 库的 Microsoft Game Core 版本的应用需要等待 Game Core 网络堆栈初始化,然后再调用此方法。 可以使用 Game Core XNetworkingGetConnectivityHint API 来确定网络堆栈的状态。

使用 Party 库的 Microsoft Game Core 版本的应用必须通过 RegisterAppStateChangeNotification API 侦听应用状态通知。 当应用挂起时,应用必须调用 PartyManager::Cleanup()。 恢复应用后,游戏必须等待 Game Core 网络堆栈准备就绪,然后通过调用 PartyManager::Initialize() 重新初始化 Party 库。

提供的 titleId 必须是用于获取将传递给 CreateLocalUser()的 PlayFab 实体 ID 和实体令牌的同一标题 ID。

要求

标题: Party.h

另请参阅

PartyManager
PartyManager::CreateLocalUser
PartyManager::Cleanup
PartyManager::GetSingleton
PartyManager::SetMemoryCallbacks
PartyManager::GetMemoryCallbacks
PartyManager::SetThreadAffinityMask
PartyManager::GetThreadAffinityMask
PartyManager::SerializeNetworkDescriptor
PartyManager::DeserializeNetworkDescriptor