> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PartyXblManager::Initialize

> PartyXboxLive.h 中的 PartyXblManager::Initialize 初始化用于将 XBOX Live 标识与 PlayFab Party SDK 帮助程序库进行桥接的单例管理器。

初始化对象实例。

## 语法

```cpp theme={null}
PartyError Initialize(  
    PartyString titleId  
)  
```

### 参数

**`titleId`**   [PartyString](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/typedefs.md)

应用的 PlayFab Title Id。

### 返回值

PartyError

若调用成功则返回 `c_partyErrorSuccess`,否则返回错误代码。可通过 [GetErrorMessage()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_geterrormessage.md) 检索该错误代码的可读形式。

## 备注

必须在调用 PartyXblManager 命名空间下的任何其他方法之前调用此方法,静态方法 [GetSingleton()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getsingleton.md)、[SetMemoryCallbacks()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_setmemorycallbacks.md)、[GetMemoryCallbacks()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getmemorycallbacks.md)、[SetThreadAffinityMask()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_setthreadaffinitymask.md)、[GetThreadAffinityMask()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getthreadaffinitymask.md) 除外。在没有后续 [Cleanup()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_cleanup.md) 调用的情况下,不能再次调用 Initialize()。\
\
&#x20;每次调用 Initialize() 都应有一次对应的 Cleanup() 调用。\
\
&#x20;建议使用 Party XBOX Live 帮助程序库 XBOX One XDK 版本的应用等待平台准备好进行网络操作后再调用此方法。有关网络和安全设备关联最佳实践的详细信息,请参考 XDK 文档。\
\
&#x20;使用 Party XBOX Live 帮助程序库 Microsoft Game Core 版本的应用需要在调用此方法之前等待 Game Core Networking 堆栈初始化。可以使用 Game Core XNetworkingGetConnectivityHint API 确定网络堆栈的状态。\
\
&#x20;使用 Party XBOX Live 帮助程序库 Microsoft Game Core 版本的应用必须通过 RegisterAppStateChangeNotification API 侦听应用状态通知。当应用被挂起时,标题必须调用 Cleanup()。当应用恢复时,标题必须等待 Game Core 网络堆栈准备就绪,然后通过调用 Initialize() 重新初始化 Party XBOX Live 帮助程序库。

## 要求

**头文件:** PartyXboxLive.h

## 另请参阅

[PartyXblManager](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/partyxblmanager.md)\
[PartyXblManager::Cleanup](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_cleanup.md)\
[PartyXblManager::GetSingleton](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getsingleton.md)\
[PartyXblManager::SetMemoryCallbacks](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_setmemorycallbacks.md)\
[PartyXblManager::GetMemoryCallbacks](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getmemorycallbacks.md)\
[PartyXblManager::SetThreadAffinityMask](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_setthreadaffinitymask.md)\
[PartyXblManager::GetThreadAffinityMask](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getthreadaffinitymask.md)


## Related topics

- [PartyXblManager::Cleanup](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_cleanup.md)
- [PartyXblManager::GetMemoryCallbacks](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getmemorycallbacks.md)
- [PartyXblManager](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/partyxblmanager.md)
- [PartyXblManager::SetThreadAffinityMask](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_setthreadaffinitymask.md)
- [PartyXblManager::GetThreadAffinityMask](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getthreadaffinitymask.md)
