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

# 搭配 Godot 使用 GDK

> 使用僅限原始碼的 XBOX Godot 範例，將 XBOX GDK、XBOX services、PlayFab 和 GameInput 整合到 Godot 專案中，以發行至 PC 版 XBOX。

# 開始使用 Godot

本文說明如何開始使用 Godot 搭配 Microsoft Game Development Kit (GDK) 建置 PC 版 XBOX 遊戲。它會引導您參考 **XBOX Godot 範例** (示範如何將 GDK、XBOX services 和 PlayFab 整合到 Godot 專案中)，以及 **XBOX Godot NetRumble** (以該範例為基礎建置的完整多人遊戲)。本文也說明在哪裡可以找到將 Godot 遊戲發行至 XBOX Series X|S 或 XBOX One 的指引。

Godot 是可搭配 GDK 使用的數種引擎之一。如需引擎選項的概觀以及 GDK 如何融入每種引擎，請參閱 [Microsoft Game Development Kit 與遊戲引擎](/zh-TW/build/gdk-and-engines/gdk-and-engines)。

## XBOX Godot 範例

[XBOX Godot 範例](https://aka.ms/XBOXGodotSample)是 GitHub 上公開、僅限原始碼的參考。它是一個可運作的範例，說明如何建置整合 Microsoft GDK、XBOX services 和 PlayFab 的 Godot 擴充功能。有了它，您無須離開您已經喜愛的引擎，就能為 PC 版 XBOX 建置遊戲。此範例提供模組化的參考，包括如何將 Microsoft GDK 和 PlayFab SDK 一起整合或分別整合。

> \[!TIP]
> **v0.2.0 和 v0.3.0** 版本新增了 PlayFab Party 聊天指示器、語音控制項、文字轉語音和網路診斷，完成了 XUser API 包裝函式，新增 Godot .NET (C#) 支援，擴大了 GDK 和 Godot 版本相容性，並將 GDK API 參考涵蓋範圍擴充至 100%，同時包含社群回報的修正。如需這些版本的詳細資料，請參閱[版本資訊](#release-notes)。

> \[!NOTE]
> **v0.3.0 包含重大變更。** GDK 附加元件中每個指令碼可見的型別都已重新命名，例如 `GDKUser` 現在是 `XboxUser`，而 C# 命名空間 `GodotGdk` 現在是 `GodotXbox`。不提供已淘汰的別名，因此現有專案必須先更新其型別參考才能載入。引擎單一實例仍命名為 `GDK`，因此 `GDK.initialize()` 等呼叫不受影響。範例隨附一個 codemod，可自動完成大部分的變更。如需詳細資料，請參閱[重大變更：GDK 附加元件型別重新命名](/zh-TW/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0#breaking-change-gdk-addon-type-rename)。

### 包含的內容

XBOX Godot 範例涵蓋 Godot 遊戲開發人員為 PC 版 XBOX 建置遊戲所需內容的相當大一部分，並在下列項目中示範主要功能：

* Microsoft GDK 平台服務
* XBOX services
* PlayFab Core + Services
* PlayFab Multiplayer (Lobby、Matchmaking、Party)
* PlayFab Game Saves
* GameInput (包括橋接至 Godot 的 Input / InputMap)

從 v0.2.0 開始，除了 GDScript 之外，範例也透過受控 C# 路線支援 Godot .NET (C#) 專案。

從 XBOX services 到 GameInput，此範例會向您展示如何透過 Godot 將登入、遊戲手把控制器支援功能等帶入您的遊戲中。它包含深入解析和可重複使用的整合程式碼，並可直接支援廣泛的 GDK 版本和 Godot 版本。如需每個版本所驗證的特定 GDK 版本和 Godot 版本，請參閱[版本資訊](#release-notes)。

### 這是什麼，不是什麼

* 這是僅限原始碼的範例，而不是產品。包裝函式層採用 MIT 授權；GDK 和 PlayFab 相依性仍需要各自安裝並接受授權，與我們其他 XBOX 範例一致。

* 支援或維護沒有固定的更新頻率。我們會關注存放庫、監控問題，並在合理的情況下反覆改進，但這不是商業版本。儘管如此，在我們共同發展此範例的過程中，我們很期待聽到您的意見反應，並看到任何社群 PR。

* 這是將 Godot 帶到 PC 版 XBOX 的第一步。我們計劃根據社群告訴我們最有價值的內容，隨著時間持續發展它。

* 此範例是專為 PC 版 XBOX 建置的。它不包含對 XBOX Series X|S 或 XBOX One 的支援。如需主機支援的相關資訊，請參閱下方的 XBOX Series X|S 和 XBOX One 支援一節。

### 開始使用

使用這些資源來複製存放庫、建置擴充功能，並開始與您的 Godot 專案整合：

* **XBOX Godot 範例：** [XBOX Godot 範例](https://aka.ms/XBOXGodotSample) - 將 Microsoft GDK、PlayFab 和 GameInput 繫結至 Godot 的範例實作。
* **Microsoft GDK：** [microsoft/GDK](https://github.com/microsoft/GDK) - Microsoft 公開 GDK。
* **PlayFab SDK：** [PlayFab Unified SDK](https://aka.ms/PlayFabUnifiedSDK) - PlayFab Unified SDK。
* **GameInput：** [GameInput](https://aka.ms/GameInput) - 新一代輸入 API，透過單一一致的介面公開各種輸入裝置。
* **文件：** [XBOX Godot 文件](https://aka.ms/XBOXGodotDocs) - Godot XBOX 範例的文件。
* **問題：** [XBOX Godot 問題](https://aka.ms/XBOXGodotIssues) - 回報錯誤、要求功能或回饋貢獻。

將 Microsoft GDK 與您的 Godot 專案整合之後，請依照 [PC 端對端指南](/zh-TW/build/gdk-and-engines/overview)的其餘部分註冊您的遊戲、在 Partner Center 中設定您的產品，並將遊戲發行至 Microsoft Store。

## XBOX Godot NetRumble

[XBOX Godot NetRumble](https://github.com/microsoft/xbox-godot-netrumble) 是一款以 XBOX Godot 範例附加元件為基礎建置的完整、可遊玩 Godot 4 多人遊戲。它於 2026 年 9 月 10 日發行，展示 GDK、XBOX services 和 PlayFab 如何在一個執行中的遊戲裡協同運作，而不是作為零散的各 API 範例。

登入、加入代碼工作階段探索、Party 網路、語音和輸入文字、權限和隱私權、內容管理、成就和 Game Save 都從頭到尾串接在一個小型競技場遊戲中，讓您能看到要發行的遊戲必須做對的呼叫順序、失敗處理和生命週期處理。PlayFab Party 被包裝成可直接替換的 Godot `MultiplayerPeer`，因此範例中的每個 `@rpc` 都保持為一般的 Godot RPC，您現有的網路程式碼也能繼續運作。每個平台呼叫都位於單一服務外觀之後，每個關注點一個檔案，因此您可以直接取出所需的部分。範例也會將其涵蓋的每項 XBOX Requirement 對應至實作它的程式碼，讓您在認證上搶得先機。

同一個專案以 PC 版 XBOX 和 XBOX Series X|S 為目標。匯出至主機另外需要 W4 Games 的 Godot 主機分支。

與 XBOX Godot 範例一樣，NetRumble 是採用 MIT 授權的僅限原始碼參考，而非經過認證的遊戲。如需詳細資料，請參閱 [XBOX Godot NetRumble 範例 v0.1.0 版本](/zh-TW/build/gdk-and-engines/godot-release-notes/godot-netrumble-release-notes-0-1-0)。

## 版本資訊

XBOX Godot 範例會根據社群意見反應隨時間持續演進。各版本的版本資訊會說明每個版本中的新功能、改進和修正，以及針對該版本驗證的 GDK 版本和 Godot 版本。

* [XBOX Godot NetRumble 範例 v0.1.0 版本](/zh-TW/build/gdk-and-engines/godot-release-notes/godot-netrumble-release-notes-0-1-0)
* [XBOX Godot 範例 v0.3.0 版本](/zh-TW/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-3-0)
* [XBOX Godot 範例 v0.2.0 版本](/zh-TW/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-2-0)
* [XBOX Godot 範例 v0.1.0 版本](/zh-TW/build/gdk-and-engines/godot-release-notes/godot-release-notes-0-1-0)

如需完整的版本歷程記錄和下載，請參閱 GitHub 上的 [XBOX Godot 範例版本](https://github.com/microsoft/XBOX-Godot-Sample/releases)。

## XBOX Series X|S 和 XBOX One 支援

XBOX Godot 範例是專為 PC 版 XBOX 建置的，不包含對 XBOX Series X|S 或 XBOX One 的支援。

由於 Godot 是開放原始碼且採用 MIT 授權，Godot Foundation 不會正式維護主機匯出範本。主機 SDK 是在保密協定 (NDA) 下散發的，需要法律合約和封閉存取，這與引擎的開放開發模式不相容。

如需主機移植流程的最新詳細資料、中介軟體提供者清單，以及其他 Godot Foundation 指引的連結，請參閱官方 Godot Engine 網站上的 [Godot 與主機移植](https://godotengine.org/consoles/)。

如果您已經在為 XBOX Series X|S 或 XBOX One 建置遊戲，請連絡您的 XBOX 代表。如果您尚未註冊，請參閱[註冊 ID@XBOX 計畫](/zh-TW/publishing/game-publishing/onboarding/onboarding-join-id-at-xbox)以開始使用。

## 相關主題

* [Microsoft Game Development Kit 與遊戲引擎](/zh-TW/build/gdk-and-engines/gdk-and-engines)
* [PC 端對端指南概觀](/zh-TW/build/gdk-and-engines/overview)


## Related topics

- [在 Godot 中使用 GDK](/zh-CN/build/gdk-and-engines/godot.md)
- [Godot で GDK を使用する](/ja-jp/build/gdk-and-engines/godot.md)
- [开发一款新的 GDK 游戏](/zh-CN/home/build-first-title/developing-new-titles.md)
- [開發新的 GDK 遊戲](/zh-TW/home/build-first-title/developing-new-titles.md)
- [Godot 與社群引擎總覽](/zh-TW/paths/community-engines/overview.md)