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

# PlayFab for Unreal Engine 概觀

> 開始使用 PlayFab for Unreal Engine (v2 Unified)，這是涵蓋驗證、服務、Lobby、Matchmaking 和 Party 的外掛程式套件組合。

# PlayFab for Unreal Engine (v2 Unified)

PlayFab for Unreal Engine (v2 Unified) 是以 [PlayFab Unified SDK](/zh-TW/services/playfab/sdks/unified-sdk/overview) 為基礎建置的新一代整合。它為 Unreal Engine 遊戲開發人員提供與 PlayFab 後端服務的完整整合，將 Unified SDK 的新式開發做法和統一架構帶入 Unreal Engine 生態系統。

## 概觀

PlayFab for Unreal Engine 提供統一的整合體驗，將所有 PlayFab 元件整合至單一發行版本中。此發行版本包含兩個主要元件：

* **PlayFabUnreal**：提供驗證、服務和遊戲存檔的核心外掛程式。提供經濟、排行榜、玩家資料、統計資料等 PlayFab 功能。
* **OnlineSubsystemPlayFab**：Online Subsystem (OSS) 整合，可啟用 Lobby、Matchmaking、Party 網路和網際網路語音通訊協定 (VOIP)。包含跨平台遊玩、跨平台通訊，以及由 Azure 認知服務提供的協助工具功能，例如即時文字聊天翻譯和語音轉錄。

## 支援的平台

PlayFab for Unreal Engine 現在已準備好在下列平台上為您的遊戲提供支援：

* **Windows** (PC 和掌上型裝置)
* **XBOX** (One、Series S|X、Cloud)
* **Steam Deck**
* **PlayStation** (PS4、PS5)
* **Nintendo Switch** (Switch 1、Switch 2)

對其他平台的支援正在開發中。如需最新的平台可用性更新，請查看 [GitHub 存放庫](https://github.com/PlayFab/PlayFabSDK_Unreal)。

<Info>
  建議所有新專案都使用 PlayFab for Unreal Engine (v2 Unified)。它提供新式的統一架構，並改善了開發人員體驗。
</Info>

如果您的專案需要 v2 尚未支援的平台，請改用 [v1 PlayFab Unreal 外掛程式](/zh-TW/services/playfab/sdks/unreal)和 [v1 OnlineSubsystem PlayFab](/zh-TW/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview)，因為 v1 和 v2 不能在同一個專案中一起使用。

## 元件

### OnlineSubsystemPlayFab (OSS)

OnlineSubsystem PlayFab (OSS) 提供與 Unreal Engine Online Subsystem 架構的完整整合，透過標準 Unreal 介面啟用 PlayFab 的多人遊戲和網路服務。此元件包括：

* **Lobby**：使用 Unreal 的工作階段介面，建立及管理多人遊戲工作階段的遊戲大廳
* **Matchmaking**：根據技能、偏好設定和其他準則連接玩家
* **Party 資料通訊**：適用於即時多人遊戲的低延遲、跨平台傳訊
* **Party 語音聊天**：整合式語音通訊，具備 Azure 認知服務功能，例如語音轉文字和翻譯

OSS 可與 Unreal Engine 現有的網路模式順暢整合，讓您在使用熟悉的 Unreal API 的同時，也能利用 PlayFab 可調整的後端基礎結構。

OSS 也支援：

* **多個同時工作階段**：同時建立、加入和管理多個具名工作階段，例如社交大廳與進行中的比賽並存。每個具名工作階段都可以使用自己的 PlayFab Party 網路。遊戲執行個體仍然只有一個作用中的遊戲連線，且語音一次只由一個工作階段擁有。
* **專用伺服器裝載**：使用 PlayFab 伺服器實體裝載工作階段，讓專用伺服器可以在沒有已登入原生平台使用者的情況下，建立和擁有 PlayFab 大廳並管理 Party 網路。
* **可設定的可搜尋工作階段設定**：選擇哪些 Unreal 工作階段設定可透過 PlayFab Lobby 搜尋，以便針對遊戲特定的屬性 (例如遊戲模式、播放清單、技能層級或地圖) 啟用伺服器端篩選的探索。
* **Play-in-Editor (PIE)**：在 Unreal Engine 5.8 或更新版本中，以 GDK 作為原生 OSS，在單一 Play-in-Editor 執行個體中執行 OSS，讓您不需要封裝或獨立組建即可測試支援的流程。

### PlayFabUnreal 外掛程式

PlayFabUnreal 外掛程式提供核心 PlayFab 功能：

* **PlayFab Core**：驗證和事件管線 (遙測) 服務，構成所有 PlayFab 作業的基礎
* **PlayFab Services**：遊戲功能，包括排行榜、經濟、玩家資料、統計資料和目錄管理
* **PlayFab Game Saves**：跨平台雲端存檔，可跨裝置和工作階段保留玩家進度

## 開始使用

如需設定指示和詳細文件，請造訪 GitHub 存放庫：

**[GitHub 上的 PlayFab Unreal Engine 外掛程式](https://github.com/PlayFab/PlayFabSDK_Unreal)**

存放庫包括：

* 安裝和設定指南
* API 參考文件
* 範例專案和程式碼範例
* 平台特定的設定指示

## 相關資源

* [PlayFab Unified SDK 概觀](/zh-TW/services/playfab/sdks/unified-sdk/overview)
* [v1 PlayFab Unreal 外掛程式](/zh-TW/services/playfab/sdks/unreal)
* [v1 OnlineSubsystem PlayFab](/zh-TW/services/playfab/multiplayer/networking/party-unreal-engine-oss-overview)
* [PlayFab Game Saves](/zh-TW/services/playfab/player-progression/game-saves/overview)
* [PlayFab Party](/zh-TW/services/playfab/multiplayer/networking/party-sdks/overview)
* [PlayFab Multiplayer](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks)


## Related topics

- [PlayFab Unreal GSDK 外掛程式概觀](/zh-TW/services/playfab/multiplayer/servers/server-sdks/unreal-gsdk/index.md)
- [搭配 Unreal Engine 使用 GDK](/zh-TW/build/gdk-and-engines/unreal/unreal.md)
- [適用於 Unreal 的 Azure PlayFab Party Online Subsystem](/zh-TW/build/console-features/networking/game-mesh/party-unreal-online-subsystem.md)
- [Unreal Engine 快速入門](/zh-TW/services/playfab/sdks/unreal/quickstart.md)
- [PlayFab Lobby 概觀](/zh-TW/services/playfab/multiplayer/lobby/index.md)
