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

# 將 Unreal Engine 遊戲發行至 XBOX PC (UE 5.8+)

> 使用 Unreal Engine 5.8 推出的公開 GDK 外掛程式，將單一 Unreal Engine 可執行檔發佈到 Microsoft Store、Epic Games Store 和 Steam。

適用於 Unreal Engine 的 Microsoft GDK 外掛程式現已隨 Unreal Engine 5.8 版本公開提供。您可以透過 Epic Games Launcher 下載，或從 Epic Games 在 GitHub 上提供的 Unreal Engine 原始碼取得。這些外掛程式提供在 PC 版 XBOX 上建置、封裝及發行遊戲所需的一切，而且您不必離開目前使用的 Win64 平台。

這些外掛程式搭配 [GitHub 上提供的 Microsoft GDK](https://github.com/microsoft/GDK)，以及讓開發人員能以前所未有的速度開始建置的上架流程改善，是在 Unreal Engine 中為 XBOX 建置的一大進步。隨著 Unreal Engine 5.8 推出，這些外掛程式現已開放給數百萬名以 GitHub 上的 Unreal Engine 原始碼及 Epic Games Launcher 中提供的 Unreal Engine 版本進行開發的開發人員。

<Tip>
  XBOX 上架流程現在只需約 30 分鐘，而不再需要數個月。GDK 已公開、文件不需要 NDA，而且 PlayFab 對 XBOX 遊戲免費。如需完整內容，請參閱 [Press Start: Get Your PC Game Ready for XBOX in One Day](https://developer.microsoft.com/games/articles/2026/03/gdc-2026-press-start-get-your-pc-game-ready-for-xbox-in-one-day/)。
</Tip>

## 包含的內容

適用於 Unreal Engine 的 Microsoft GDK 外掛程式為建置 PC 版 XBOX 遊戲提供基礎，涵蓋商店封裝、GDK 執行階段存取、XBOX services、GameInput 等。主要外掛程式包括：

* **Microsoft GDK Store (MSGameStore)：** 在編輯器中設定遊戲，並直接從 Project Settings 為 PC 版 XBOX 產生 `.msixvc` 套件。
* **Microsoft GDK Runtime (MSGamingRuntime)：** 在執行階段存取 GDK API，以使用與 XBOX 相容的遊戲存檔、使用者選擇和系統 UI。
* **Online Subsystem GDK：** 使用 Unreal Engine 的平台抽象層來管理成就、好友、上線狀態等。
* **Online Subsystem Selector for PC GDK (MSGameOSSSelector，5.8 新增)：** 在多個 PC 商店中發行單一可執行檔，並在執行階段自動切換 Online Subsystem 行為。

其他外掛程式包括 GameInput 整合、適用於 Intelligent Delivery 的 GDK Package Chunk Installer，以及 GDK Virtual Keyboard。如需完整清單和詳細文件，請參閱 Epic Games 提供的 [GDK 外掛程式文件](https://aka.ms/ue_gdk_docs_plugins)。

## 為何這很重要

以往，在 Unreal Engine 中建置 PC 版 XBOX 遊戲需要使用 WinGDK，這是一個獨立平台，需要重複 cook，並造成協力廠商外掛程式的平台不相容問題。它也採用與其他 PC 商店不同的 PC 遊戲建置模式，增加了阻礙。新的外掛程式模式消除了這些問題。您可以留在 Win64 上，現有的協力廠商外掛程式可繼續運作，而且工作流程就像其他 PC 商店一樣，是引擎中 Win64 平台更精簡的一部分。

此外，在此之前，存取這些外掛程式需要經過管控的存取權限，屬於私人 GDK Platform Extensions 的一部分，這些擴充功能提供在 Unreal Engine 中進行 XBOX Series X|S 和 XBOX One 開發的功能。從 Unreal Engine 5.8 版開始，用於為 PC 版 XBOX 建置的外掛程式已公開，任何 Unreal Engine 開發人員都能找到並下載。沒有門檻，無須等待。

## 取得外掛程式的方式

下表依引擎版本摘要說明如何取得外掛程式。

| 引擎版本 | 取得方式 | 存取需求 |
| :- | :- | :- |
| Unreal Engine 5.8 或更新版本 | 隨附於 Epic Games Launcher 下載或 GitHub 原始碼 | 無 (公開提供) |
| Unreal Engine 5.7 | GDK Platform Extensions 下載 | XBOX 開發人員計畫成員資格 + [存取要求](https://aka.ms/ue_gdk_access) |
| Unreal Engine 4.27 到 5.6 | GDK Platform Extensions 下載 (僅限 OnlineSubsystemGDK；無 Win64 GDK 外掛程式) | XBOX 開發人員計畫成員資格 + [存取要求](https://aka.ms/ue_gdk_access) |

### 來自 GitHub 的 Unreal Engine 原始碼 (建議遊戲團隊使用)

對於遊戲團隊，我們建議使用來自 GitHub 的 Unreal Engine 原始碼。完整的原始碼存取權可實現深度自訂、偵錯進入引擎程式碼，以及整合遊戲專屬修正和最佳化的能力。

1. 在 [unrealengine.com/ue-on-github](https://www.unrealengine.com/ue-on-github) 將您的 Epic Games 帳戶連結到 GitHub 帳戶。
2. 連結後，您即可存取 [EpicGames/UnrealEngine](https://github.com/EpicGames/UnrealEngine) 私人存放庫。
3. 複製或下載 Unreal Engine 5.8 原始碼。GDK 外掛程式位於引擎原始碼中：
   * `Engine\Plugins\Runtime\Windows\MSGameStore`
   * `Engine\Plugins\Runtime\Windows\MSGamingRuntime`
   * `Engine\Plugins\Online\Microsoft\OnlineSubsystemGDK`
   * `Engine\Plugins\Runtime\Windows\MSGameOSSSelector`
4. 執行 `Setup.bat` 和 `GenerateProjectFiles.bat` 以設定組建環境。
5. 依照 [從原始碼建置 Unreal Engine](https://aka.ms/ue_build_source) 指南從原始碼建置引擎。

<Note>
  從 GitHub 原始碼建置時，GDK SDK 版本相容性定義於 `Engine\Config\Microsoft\GDK_SDK.json`。Unreal Engine 5.8 支援廣泛的 GDK 版本，最高至 2026 年 4 月 GDK (版本 250404 到 260499)。您可以使用 `winget install Microsoft.Gaming.GDK` 安裝 GDK。
</Note>

### Epic Games Launcher

如果您不需要原始碼存取權，可以透過 [Epic Games Launcher](https://aka.ms/ue_download) 下載 Unreal Engine。自 Unreal Engine 5.8 起，Microsoft GDK 外掛程式會公開隨附於引擎下載中。

1. 如果您尚未安裝 [Epic Games Launcher](https://www.unrealengine.com/download)，請先安裝。
2. 從啟動器的 **\[Unreal Engine]** 索引標籤安裝 Unreal Engine 5.8 或更新版本。
3. Microsoft GDK 外掛程式會自動包含在內。不需要額外下載或提出存取要求。

### GDK Platform Extensions (Unreal Engine 5.7)

對於 Unreal Engine 5.7，GDK 外掛程式是 GDK Platform Extensions 的一部分。這些擴充功能需要加入 XBOX 開發人員計畫 (例如 ID\@XBOX)，並另外提出存取要求。

1. 加入 [XBOX 開發人員計畫](https://aka.ms/gdk_id)，例如 ID\@XBOX。
2. 使用 [存取要求表單](https://aka.ms/ue_gdk_access)，要求存取 Unreal Engine 的 Developer Community GDK 群組。
3. 核准後，下載 GDK Platform Extensions。外掛程式位於 `Engine\Platforms\GDK\Plugins` 資料夾中。

如需設定 GDK Platform Extensions 的詳細資訊，請參閱 [開始使用 Unreal Engine 進行 PC 開發](/zh-TW/build/gdk-and-engines/unreal/unreal)。

## 如何開始使用

1. **安裝 Unreal Engine 5.8**，可透過 [GitHub 原始碼](https://www.unrealengine.com/ue-on-github) (建議) 或 [Epic Games Launcher](https://aka.ms/ue_download) 取得。
2. **安裝 Microsoft GDK。** Unreal Engine 5.8 支援廣泛的版本，最高至 2026 年 4 月 GDK。從終端機使用 `winget install Microsoft.Gaming.GDK` 安裝，或從 [aka.ms/gdkdl](https://aka.ms/gdkdl) 下載。
3. 在外掛程式功能表中**啟用 Microsoft GDK 外掛程式**，並在 **MS Gaming (PC GDK)** 下設定 Project Settings，以將遊戲與 [Microsoft Partner Center](https://partner.microsoft.com/dashboard/windows/overview) 建立關聯。
4. **設定及封裝遊戲：** 設定中繼資料，並直接從編輯器產生 `.msixvc` 套件。

如果您有現有的 WinGDK 遊戲，可使用隨附的移轉指令碼逐步完成轉換：

```bat theme={null}
RunUAT MigrateWinGDK -project=Path/To/Project.uproject
```

如需詳細的外掛程式設定、組態和封裝步驟，請參閱 [開始使用 Unreal Engine 進行 PC 開發](/zh-TW/build/gdk-and-engines/unreal/unreal)。

<Note>
  若要在 XBOX 上發佈遊戲，您需要 [註冊 ID@XBOX](https://aka.ms/id)。註冊程序約需 30 分鐘，在申請處理期間，您就可以開始使用 GDK 和外掛程式進行建置。
</Note>

## 資源

* [適用於 Unreal Engine 的 Microsoft GDK 外掛程式文件](https://aka.ms/ue_gdk_docs_plugins)
* [開始使用 Unreal Engine 進行 PC 開發](/zh-TW/build/gdk-and-engines/unreal/unreal)
* [Press Start: Get Your PC Game Ready for XBOX in One Day](https://developer.microsoft.com/games/articles/2026/03/gdc-2026-press-start-get-your-pc-game-ready-for-xbox-in-one-day/)
* [註冊 ID@XBOX](https://aka.ms/id)
* [GitHub 上的 XBOX GDK 範例](https://github.com/microsoft/Xbox-GDK-Samples)

## 另請參閱

* [開始使用 Unreal Engine 進行 PC 開發](/zh-TW/build/gdk-and-engines/unreal/unreal)
* 適用於所有遊戲的步驟
* [Epic Games 提供的 GDK 外掛程式文件](https://aka.ms/ue_gdk_docs_plugins)


## Related topics

- [將 GDK 與自訂 C/C++ 引擎整合](/zh-TW/build/gdk-and-engines/custom-engine.md)
- [XBOX 遊戲發行概觀](/zh-TW/publishing/game-publishing/publishing-processes/managed-creators/overview.md)
- [將 GDK 整合到 4.26 版之前的 Unreal Engine 專案](/zh-TW/build/gdk-and-engines/unreal/unreal-legacy.md)
- [XBOX 遊戲發行整備檢查清單](/zh-TW/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-game-publishing-readiness-checklist.md)
- [搭配 Unity、Unreal 和其他引擎使用 GDK](/zh-TW/build/gdk-and-engines/gdk-and-engines.md)