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

# 搭配 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。

## 選擇您的引擎指南

<CardGroup cols={2}>
  <Card title="Unity" icon="cube" href="/zh-TW/build/gdk-and-engines/unity/unity">
    適用於 Unity 的 XBOX GDK API + Tools 套件。可從單一專案以 Windows、XBOX Series X|S 和 XBOX One 為目標。另請參閱 [C# API 包裝函式參考](/zh-TW/build/gdk-and-engines/unity/unity-api-wrappers)。
  </Card>

  <Card title="Unreal Engine" icon="u" href="/zh-TW/build/gdk-and-engines/unreal/unreal">
    由 Epic 散發的 XBOX GDK 外掛程式 (Win64) 和 GDK Platform Extensions (主機)。包括 UE 5.7 (私人擴充功能) 和 UE 5.8+ ([搭配 MSGameOSSSelector 的公開外掛程式](/zh-TW/build/gdk-and-engines/unreal/unreal-xbox-pc))。
  </Card>

  <Card title="GameMaker" icon="gamepad" href="/zh-TW/build/gdk-and-engines/gamemaker">
    適用於 PC 版 Microsoft Store 的 GMEXT-GDK 擴充功能。
  </Card>

  <Card title="Godot" icon="circle" href="/zh-TW/build/gdk-and-engines/godot">
    適用於 PC 版 XBOX 的開放原始碼 XBOX Godot 範例。
  </Card>

  <Card title="自訂 C/C++ 引擎" icon="code" href="/zh-TW/build/gdk-and-engines/custom-engine">
    將 GDK 和 XSAPI 直接整合到您的引擎中。
  </Card>
</CardGroup>

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

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

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

請參閱：

* [PC 端對端概觀](/zh-TW/build/gdk-and-engines/overview) — 從註冊到發行的完整路徑。
* [選用服務](/zh-TW/build/gdk-and-engines/optional-services) — 您可以額外新增的功能。
* [上線](/zh-TW/home/onboarding) — 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 之前的舊版指南](/zh-TW/build/gdk-and-engines/unreal/unreal-legacy)。
* **Unity**：GDK API 和 Tools 套件從標準 Windows 建置設定檔以 Windows 為目標。

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

## 相關 API 文件

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


## Related topics

- [在 Unity、Unreal 及其他引擎中使用 GDK](/zh-CN/build/gdk-and-engines/gdk-and-engines.md)
- [Unreal Engine 概览](/zh-CN/paths/unreal/overview.md)
- [Unreal Engine 總覽](/zh-TW/paths/unreal/overview.md)
- [Unity 概览](/zh-CN/paths/unity/overview.md)
- [GameInput 常见问题](/zh-CN/build/core-features/common/input/overviews/input-faq.md)