> ## 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 物件執行個體。

## 語法

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

### 參數

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

應用程式的 PlayFab 遊戲識別碼 (Title ID)。

### 傳回值

PartyError

`c_partyErrorSuccess` (如果呼叫成功)，否則為錯誤碼。可透過 [GetErrorMessage()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_geterrormessage.md) 擷取錯誤碼的人類可讀形式。

## 備註

除了靜態方法 [GetSingleton()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getsingleton.md)、[SetMemoryCallbacks()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setmemorycallbacks.md)、[GetMemoryCallbacks()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getmemorycallbacks.md)、[SetThreadAffinityMask()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setthreadaffinitymask.md)、[GetThreadAffinityMask()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getthreadaffinitymask.md)、[SerializeNetworkDescriptor()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_serializenetworkdescriptor.md)、[DeserializeNetworkDescriptor()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_deserializenetworkdescriptor.md)、[SetWorkMode()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_setworkmode.md) 和 [GetWorkMode()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_getworkmode.md) 之外，必須先呼叫此方法，才能呼叫任何其他方法。在後續呼叫 [Cleanup()](https://docs.xbox.com/zh-TW/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` 必須與用來取得 PlayFab 實體識別碼和實體權杖的遊戲識別碼相同，這些實體識別碼和權杖將傳遞給 [CreateLocalUser()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md)、[CreateLocalUserWithEntityType()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md) 和 [PartyLocalUser::UpdateEntityToken()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyLocalUser/methods/partylocaluser_updateentitytoken.md)。

## 需求

**標頭：** Party.h

## 另請參閱

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


## Related topics

- [PartyManager::Cleanup](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_cleanup.md)
- [PartyManager::CreateLocalUser](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluser.md)
- [PartyManager::CreateLocalUserWithEntityType](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/reference/classes/PartyManager/methods/partymanager_createlocaluserwithentitytype.md)
- [PlayFab Party 版本資訊](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/release-notes.md)
- [移轉指南：PlayFab 獨立 SDK (v1) 至 PlayFab Unified SDK (v2)](https://docs.xbox.com/zh-TW/services/playfab/sdks/unified-sdk/migrating-from-v1.md)