Skip to main content

​
開始使用 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 與遊戲引擎。

​
XBOX Godot 範例

XBOX Godot 範例是 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%，同時包含社群回報的修正。如需這些版本的詳細資料，請參閱版本資訊。
[!NOTE] v0.3.0 包含重大變更。 GDK 附加元件中每個指令碼可見的型別都已重新命名，例如 GDKUser 現在是 XboxUser，而 C# 命名空間 GodotGdk 現在是 GodotXbox。不提供已淘汰的別名，因此現有專案必須先更新其型別參考才能載入。引擎單一實例仍命名為 GDK，因此 GDK.initialize() 等呼叫不受影響。範例隨附一個 codemod，可自動完成大部分的變更。如需詳細資料，請參閱重大變更：GDK 附加元件型別重新命名。

​
包含的內容

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 版本，請參閱版本資訊。

​
這是什麼，不是什麼

  • 這是僅限原始碼的範例，而不是產品。包裝函式層採用 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 範例 - 將 Microsoft GDK、PlayFab 和 GameInput 繫結至 Godot 的範例實作。
  • Microsoft GDK： microsoft/GDK - Microsoft 公開 GDK。
  • PlayFab SDK： PlayFab Unified SDK - PlayFab Unified SDK。
  • GameInput： GameInput - 新一代輸入 API，透過單一一致的介面公開各種輸入裝置。
  • 文件： XBOX Godot 文件 - Godot XBOX 範例的文件。
  • 問題： XBOX Godot 問題 - 回報錯誤、要求功能或回饋貢獻。
將 Microsoft GDK 與您的 Godot 專案整合之後，請依照 PC 端對端指南的其餘部分註冊您的遊戲、在 Partner Center 中設定您的產品，並將遊戲發行至 Microsoft Store。

​
XBOX Godot NetRumble

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 版本。

​
版本資訊

XBOX Godot 範例會根據社群意見反應隨時間持續演進。各版本的版本資訊會說明每個版本中的新功能、改進和修正，以及針對該版本驗證的 GDK 版本和 Godot 版本。 如需完整的版本歷程記錄和下載，請參閱 GitHub 上的 XBOX Godot 範例版本。

​
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 與主機移植。 如果您已經在為 XBOX Series X|S 或 XBOX One 建置遊戲，請連絡您的 XBOX 代表。如果您尚未註冊，請參閱註冊 ID@XBOX 計畫以開始使用。

​
相關主題

Last modified on October 6, 2026