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

# 搭配 Unity、Unreal 和其他引擎使用 GDK

> 了解 XBOX GDK 如何透過外掛程式、擴充功能和專案範本，與 Unity、Unreal Engine、GameMaker、Godot 以及自訂 C 或 C++ 引擎整合。

XBOX GDK 為 PC 和 XBOX 上與 XBOX 生態系統相關的一切提供 API。您可以透過三種方式使用 GDK：

1. **直接使用 C/C++** — 從頭撰寫的遊戲中直接呼叫 GDK API (使用 GDK 專案範本)。
2. **具有 GDK 整合的遊戲引擎** — 使用 Unity、Unreal、GameMaker 或其他具有 Microsoft 支援之 GDK 外掛程式或擴充功能的引擎。
3. **自訂 C/C++ 引擎** — 將 GDK 標頭、程式庫和 DLL 整合到您的內部引擎中。

從 [GitHub](https://github.com/microsoft/GDK) 下載 GDK。

## 選擇您的引擎指南

> [card] [Unity](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unity/unity.md)
>
> 適用於 Unity 的 XBOX GDK API + Tools 套件。可從單一專案以 Windows、XBOX Series X|S 和 XBOX One 為目標。另請參閱 [C# API 包裝函式參考](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers.md)。

> [card] [Unreal Engine](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unreal/unreal.md)
>
> 由 Epic 散發的 XBOX GDK 外掛程式 (Win64) 和 GDK Platform Extensions (主機)。包括 UE 5.7 (私人擴充功能) 和 UE 5.8+ ([搭配 MSGameOSSSelector 的公開外掛程式](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unreal/unreal-xbox-pc.md))。

> [card] [GameMaker](https://docs.xbox.com/zh-TW/build/gdk-and-engines/gamemaker.md)
>
> 適用於 PC 版 Microsoft Store 的 GMEXT-GDK 擴充功能。

> [card] [Godot](https://docs.xbox.com/zh-TW/build/gdk-and-engines/godot.md)
>
> 適用於 PC 版 XBOX 的開放原始碼 XBOX Godot 範例。

> [card] [自訂 C/C++ 引擎](https://docs.xbox.com/zh-TW/build/gdk-and-engines/custom-engine.md)
>
> 將 GDK 和 XSAPI 直接整合到您的引擎中。

## 所有引擎路徑的共同點

無論使用哪種引擎，每個 GDK PC 遊戲都需要：

* 具有 Title ID、Store ID 和 MSAAppId 的 **Partner Center 產品**。
* 包含 Partner Center 中各值的 **`MicrosoftGame.config`**。
* **MSIXVC 套件** (由 `makepkg`、您引擎的工具或編輯器建置)。
* **測試沙箱**以及至少一個**測試帳戶**。

請參閱：

* [PC 端對端概觀](https://docs.xbox.com/zh-TW/build/gdk-and-engines/overview.md) — 從註冊到發行的完整路徑。
* [選用服務](https://docs.xbox.com/zh-TW/build/gdk-and-engines/optional-services.md) — 您可以額外新增的功能。
* [上線](https://docs.xbox.com/zh-TW/home/onboarding.md) — ID\@XBOX 註冊。

## 為什麼是 "Win64" 而不是 "WinGDK"？

Microsoft 與引擎合作夥伴已一致同意在標準 **Win64** 平台上建置 GDK PC 遊戲。這會統一各商店的 PC 建置路徑、縮短 cook 時間，並改善外掛程式相容性。

* **Unreal**：在 UE 5.7+ 中，XBOX GDK 外掛程式以 Win64 為目標。在 UE 5.8+ 中，外掛程式會隨引擎公開發行，而且單一 `.exe` 即可透過 `MSGameOSSSelector` 涵蓋 Microsoft Store、Epic 和 Steam。WinGDK 為舊版；如果您無法升級，請參閱 [4.26 之前的舊版指南](https://docs.xbox.com/zh-TW/build/gdk-and-engines/unreal/unreal-legacy.md)。
* **Unity**：GDK API 和 Tools 套件從標準 Windows 建置設定檔以 Windows 為目標。

對於自訂引擎，請在 PC 上使用 `WINAPI_FAMILY_DESKTOP_APP` API 分割 — 可使用完整的 Win32 介面。

## 相關 API 文件

* [XGameRuntime 功能參考](https://docs.xbox.com/zh-TW/reference/system/xgameruntimefeature/xgameruntimefeature_members.md) — 每個引擎整合都會使用的 GDK API
* [XStore API 參考](https://docs.xbox.com/zh-TW/reference/system/xstore/xstore_members.md) — PC 上的商務介面


## Related topics

- [Unreal Engine 總覽](https://docs.xbox.com/zh-TW/paths/unreal/overview.md)
- [GameInput 常見問題集](https://docs.xbox.com/zh-TW/build/core-features/common/input/overviews/input-faq.md)
- [PC 端對端指南概觀](https://docs.xbox.com/zh-TW/build/gdk-and-engines/overview.md)
- [適用於 GDK 的 PlayFab Services](https://docs.xbox.com/zh-TW/services/playfab/sdks/platforms/gdk.md)
- [開發新的 GDK 遊戲](https://docs.xbox.com/zh-TW/home/build-first-title/developing-new-titles.md)
