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

# Azure PlayFab Party

> Azure PlayFab Party

# Azure PlayFab Party

使用本主題了解如何搭配 Microsoft Game Development Kit (GDK) 使用 PlayFab Party。[PlayFab Party](/zh-TW/services/playfab/multiplayer/networking) 能以彈性、包容且安全的方式，簡化在遊戲中新增低延遲聊天與資料通訊的工作。當不需要雲端裝載的專用伺服器時 (有時稱為*點對點遊戲*或 *P2P 遊戲*)，Party 是多人遊戲實作的理想選擇。即使您使用雲端伺服器作為遊戲主機，Party 也能為應用程式內的社交體驗 (例如遊戲內小隊或遊戲後大廳) 提供語音和文字通訊。Party 是 XBOX One ERA Secure Sockets API 在 Microsoft Game Development Kit (GDK) 中的後繼者。

Party 使用 Azure 認知服務來轉譯使用者語音聊天，並將文字合成為語音，這主要是設計作為協助工具輔助。PlayFab Party 語音聊天的一般使用量是以每分鐘計費。最多 10% 的語音分鐘數可以免費使用轉譯和合成。建議您將此功能的啟用與輕鬆存取使用者設定綁定。

> \[!NOTE]
> Party 也會即時翻譯聊天。在匿名配對和國際競技遊戲中，這些轉譯和翻譯功能能帶來更吸引人的多人遊戲體驗。

PlayFab Party (以及我們的其他多人遊戲服務) 的主要目標，是促進可互通的多人遊戲基礎結構和跨網路遊戲。請確認您的多人遊戲體驗符合多人遊戲和跨網路使用者活動的相關平台原則。

## PlayFab Party 功能

* **加密和驗證：** Party 會使用使用者的 PlayFab 使用者身分識別來驗證使用者裝置，並使用類似 DTLS 的通訊協定加密資料。
* **裝置對裝置資料包網路：** Party 的核心是在全球 Azure 雲端上裝載的轉送。使用者裝置會使用這些轉送來建立 Party 網路，並彼此傳送遊戲資料。Party 網路系統包含可設定的傳輸功能，例如遇到封包遺失時自動重試。
* **語音和文字聊天：** 使用者裝置可以將音訊裝置繫結至 Party 網路，以進行即時語音聊天。Party 也支援使用者之間的文字聊天訊息。
* **語音轉文字和語音合成：** Party 可以轉譯使用者語音聊天，並為文字訊息合成語音。此功能有多種用途，但主要是設計作為協助工具輔助。
* **即時翻譯：** Party 可以理解並合成使用者語音和文字聊天的即時翻譯。

## Microsoft Game Development Kit (GDK) 考量

### XBOX services 需求

XBOX services 遊戲的使用者通訊必須符合數項使用者安全需求。搭配 PlayFab Party XBOX services 外掛程式使用 PlayFab Party，可確保您的遊戲符合所有 XBOX services 通訊和安全性需求。

> \[!NOTE]
> *XBOX 需求* (XR) 是遊戲在 XBOX 平台上發佈之前必須符合的需求。

* **XR-015：** 管理玩家通訊。
* **XR-045：** XBOX services 和帳戶權限。XBOX services 外掛程式只會強制執行 *XPRIVILEGE\_COMMUNICATIONS* 部分。如果您的遊戲使用其他 XBOX services 功能，您必須執行必要的權限檢查。
* **XR-072：** 支援語音。
* **跨網路遊玩：** PlayFab Party 只會強制執行需要伺服器的*跨網路遊戲*部分。您的遊戲需負責必要的權限檢查和 XBOX services 互動。
* **XR-064：** 可加入的遊戲工作階段和線上遊玩
* **XR-067：** 維護最近一起玩過的互動

## 網路初始化

PlayFab Party 不會自動為 Microsoft Game Development Kit (GDK) 遊戲處理[網路初始化](/zh-TW/build/console-features/networking/initialization-connectivity-networking#ID4ETA)。請等待網路完成初始化後，再呼叫 PlayFab Party。在網路初始化之前，Party API 都會失敗。

<a id="SuspendResume" />

## 暫停與繼續

您應該透過 `RegisterAppStateChangeNotification` 註冊暫停和繼續事件。暫停時，使用 `PartyManager::Cleanup()` 清除 Party。繼續時，您應該再次等待網路初始化，再呼叫 `PartyManager::Initialize()`。如果您嘗試跨越暫停/繼續週期使用 Party API，這些 API 會失敗。

`PartyManager::Cleanup()` 可能需要幾百毫秒才能完成。建議您將 Party 的清除與其他暫停作業平行進行，以避免暫停逾時。如果以非同步方式呼叫 `Partymanager::Cleanup()`，您應該確保在 Party 的清除傳回之前封鎖暫停通知。

## 定價資訊

使用 XBOX services 身分識別時，PlayFab Party 可在 Microsoft Game Development Kit (GDK) 中免費使用。如需定價和計費的詳細資訊，請參閱 [XBOX services 免費方案常見問題集](https://learn.microsoft.com/gaming/playfab/multiplayer/networking/xbl-discount)。

## 在 PlayFab 入口網站中設定您的遊戲

1. 前往 [https://developer.playfab.com/](https://developer.playfab.com/)，然後建立帳戶。
2. 使用您的新帳戶建立 PlayFab 工作室和遊戲識別碼。
3. 前往您新建立的遊戲，選取 \[**多人遊戲**] 區段，然後選取 \[**Party (預覽)**] 索引標籤。
4. 選取 \[**啟用**]，然後輸入存取碼 **XBOX Live**。片刻之後，Party 就會啟用。
5. 在 \[**API 功能**] 索引標籤上，複製您的 PlayFab 遊戲識別碼和實體 ICD。
6. 將遊戲識別碼和實體 ICD 新增至用戶端 PlayFab Party API 初始化函式。您現在可以在 Microsoft Game Development Kit (GDK) 遊戲中使用 PlayFab Party。

如需詳細資訊，請參閱[快速入門：Game Manager](/zh-TW/services/playfab/live-service-management/gamemanager/quickstart)。

## 使用 Visual Studio 將 PlayFab Party 程式庫新增至您的 Microsoft Game Development Kit (GDK) 專案

1. 在 Visual Studio 方案總管中以滑鼠右鍵按一下您的專案，然後選取 \[**屬性**]。
2. 在 \[**組態屬性**] 中，前往 \[**XBOX One**] 區段。
3. 選取 \[**Gaming Extension Libraries**] 下拉式清單，然後新增 PlayFab Party 和 XBOX Live Helper 的參考。

> \[!NOTE]
> 程式庫會安裝在預設位置 *Program Files (x86)\Microsoft GDK\[Version]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\x64* (2024 年 10 月或更新版本) 或 *Program Files (x86)\Microsoft GDK\[Version]\GRDK\ExtensionLibraries\PlayFab.Party.Cpp\Redist\CommonConfiguration\neutral* (2024 年 6 月或更早版本) 之下。

## PlayFab Party 與沙箱

不需要為沙箱設定 PlayFab Party。無論部署至哪個沙箱，所有網路工作階段都會在零售環境中配置。如果您需要將使用者分開以進行測試，請為測試環境與零售環境建立個別的 PlayFab 遊戲識別碼。PlayFab 遊戲識別碼與您的 XBOX services 遊戲識別碼無關。一個 XBOX services 遊戲識別碼可以使用數個不同的 PlayFab 遊戲識別碼。

## 另請參閱

[PlayFab Party 概觀](/zh-TW/services/playfab/multiplayer/networking)


## Related topics

- [Azure PlayFab Party](/build/console-features/networking/game-mesh/playfab-party-intro-networking.md)
- [Azure PlayFab Party SDK for Unity](/build/console-features/networking/game-mesh/party-unity-plugin.md)
- [Azure PlayFab Party Online Subsystem for Unreal](/build/console-features/networking/game-mesh/party-unreal-online-subsystem.md)
- [Unity용 Azure PlayFab Party SDK](/ko/build/console-features/networking/game-mesh/party-unity-plugin.md)
- [SDK de Azure PlayFab Party para Unity](/es/build/console-features/networking/game-mesh/party-unity-plugin.md)