> ## 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.

# PartyManager::Initialize

> 初始化 PartyManager 对象实例。

初始化 PartyManager 对象实例。

## Syntax

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

### Parameters

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

应用的 PlayFab Title ID。

### Return value

PartyError

如果调用成功，则返回 `c_partyErrorSuccess`；否则返回错误代码。可通过 [GetErrorMessage()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) 检索错误代码的可读形式。

## Remarks

除了静态方法 [GetSingleton()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getsingleton.md)、[SetMemoryCallbacks()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks.md)、[GetMemoryCallbacks()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getmemorycallbacks.md)、[SetThreadAffinityMask()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setthreadaffinitymask.md)、[GetThreadAffinityMask()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getthreadaffinitymask.md)、[SerializeNetworkDescriptor()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_serializenetworkdescriptor.md)、[DeserializeNetworkDescriptor()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_deserializenetworkdescriptor.md)、[SetWorkMode()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setworkmode.md) 和 [GetWorkMode()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getworkmode.md) 之外，必须在调用任何其他方法之前调用此方法。如果未先调用 [Cleanup()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_cleanup.md)，则无法再次调用 Initialize()。\
\
 每次调用 Initialize() 都应有相应的 Cleanup() 调用。   \
\
 使用 Microsoft Game Core 版本 Party 库的应用在调用此方法之前需要等待 Game Core 网络堆栈初始化。可以使用 Game Core XNetworkingGetConnectivityHint API 确定网络堆栈的状态。   \
\
 使用 Microsoft Game Core 版本 Party 库的应用必须通过 RegisterAppStateChangeNotification API 侦听应用状态通知。当应用挂起时，应用必须调用 PartyManager::Cleanup()。当应用恢复时，标题必须等待 Game Core 网络堆栈就绪，然后通过调用 PartyManager::Initialize() 重新初始化 Party 库。   \
\
   在 Android 平台上构建的应用必须确保应用清单中包含 BLUETOOTH\_CONNECT，以便 Party 可以监视并连接到可用的蓝牙设备。   \
\
 提供的 `titleId` 必须与用于获取传递给 [CreateLocalUser()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md)、[CreateLocalUserWithEntityType()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md) 和 [PartyLocalUser::UpdateEntityToken()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken.md) 的 PlayFab 实体 ID 和实体令牌的标题 ID 相同。

## Requirements

**Header:** Party.h

## See also

[PartyManager](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/partymanager.md)\
[PartyManager::CreateLocalUser](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md)\
[PartyManager::CreateLocalUserWithEntityType](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md)\
[PartyManager::Cleanup](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_cleanup.md)\
[PartyManager::GetSingleton](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getsingleton.md)\
[PartyManager::SetMemoryCallbacks](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks.md)\
[PartyManager::GetMemoryCallbacks](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getmemorycallbacks.md)\
[PartyManager::SetThreadAffinityMask](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setthreadaffinitymask.md)\
[PartyManager::GetThreadAffinityMask](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getthreadaffinitymask.md)\
[PartyManager::SerializeNetworkDescriptor](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_serializenetworkdescriptor.md)\
[PartyManager::DeserializeNetworkDescriptor](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_deserializenetworkdescriptor.md)\
[PartyLocalUser::UpdateEntityToken](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken.md)


## Related topics

- [PartyManager::Cleanup](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_cleanup.md)
- [PartyManager::CreateLocalUser](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md)
- [PartyManager::CreateLocalUserWithEntityType](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md)
- [PlayFab Party 发行说明](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/networking/release-notes.md)
- [迁移指南：从 PlayFab 独立 SDK (v1) 迁移到 PlayFab 统一 SDK (v2)](https://docs.xbox.com/zh-CN/services/playfab/sdks/unified-sdk/migrating-from-v1.md)