> ## 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-TW/services/playfab/multiplayer/networking/reference/typedefs.md)

應用程式的 PlayFab 遊戲識別碼。

### 傳回值

PartyError

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

## 備註

除了靜態方法 [GetSingleton()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getsingleton.md)、[SetMemoryCallbacks()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_setmemorycallbacks.md)、[GetMemoryCallbacks()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getmemorycallbacks.md)、[SetThreadAffinityMask()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_setthreadaffinitymask.md)、[GetThreadAffinityMask()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_getthreadaffinitymask.md) 之外，必須先呼叫此方法，才能呼叫 PartyXblManager 命名空間下的任何其他方法。若未在之後呼叫 [Cleanup()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/networking/xblreference/classes/PartyXblManager/methods/partyxblmanager_cleanup.md)，就無法再次呼叫 Initialize()。\
\
&#x20;每次呼叫 Initialize() 都應有對應的 Cleanup() 呼叫。\
\
&#x20;建議使用 Party XBOX Live Helper 程式庫之 XBOX One XDK 版本的應用程式，等到平台已準備好進行網路作業之後再呼叫此方法。如需詳細資訊，請參閱 XDK 文件中關於網路和安全裝置關聯最佳做法的內容。\
\
&#x20;使用 Party XBOX Live Helper 程式庫之 Microsoft Game Core 版本的應用程式，必須等到 Game Core 網路堆疊初始化之後，才能呼叫此方法。可以使用 Game Core XNetworkingGetConnectivityHint API 判斷網路堆疊的狀態。\
\
&#x20;使用 Party XBOX Live Helper 程式庫之 Microsoft Game Core 版本的應用程式，必須透過 RegisterAppStateChangeNotification API 接聽應用程式狀態通知。當應用程式暫停時，遊戲必須呼叫 Cleanup()。當應用程式繼續執行時，遊戲必須等待 Game Core 網路堆疊就緒，然後呼叫 Initialize() 重新初始化 Party XBOX Live Helper 程式庫。

## 需求

**標頭：** PartyXboxLive.h

## 另請參閱

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


## Related topics

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