實用之處
- 一個完整遊戲,而非零散的程式碼片段。 登入、工作階段探索、網路、語音、隱私權、內容管理、成就和存檔,都串接在一個您可以從頭到尾執行的遊戲中,讓您能看到各 API 範例所省略的呼叫順序、失敗處理和生命週期處理。
- 保持道地 Godot 風格的多人遊戲。 PlayFab Party 被包裝成可直接替換的 Godot
MultiplayerPeer,因此範例中的每個@rpc都是一般的 Godot RPC。只有 peer 的建構是 PlayFab 專屬的,讓您現有的網路程式碼保持不變。 - 在認證上搶得先機。 範例包含權限檢查、個別玩家靜音、封鎖和避開的強制執行、使用者撰寫內容發佈前的文字驗證,以及玩家檢舉,並提供一個頁面將每項 XBOX Requirement 對應至實作它的程式碼。
- 同一個專案支援 PC 和主機。 同一個專案以 PC 版 XBOX 和 XBOX Series X|S 為目標,包括暫停、繼續和受限處理,以及主機上的個別使用者 Game Save。
- 可直接複製的邊界。 每個平台呼叫都位於單一服務外觀 (facade) 之後,每個關注點一個檔案,因此您可以直接取出所需的部分,而不必將其從遊戲邏輯中拆解出來。
示範內容
- 將 GDK 登入交換為 PlayFab 身分識別,並提供專用的進度畫面和離線後援。
- 使用 PlayFab Lobby 進行加入代碼工作階段探索,以及可加入的好友、活動發佈和從指南加入的邀請。
- PlayFab Party 語音和對戰中的輸入文字,並分別強制執行靜音和文字隱私權。
- 多人遊戲和通訊權限檢查,以及靜音、封鎖和避開的隱私權強制執行。
- 由對戰事件驅動的一次性和累進式成就進度。
- 主機上用於設定檔、歷程記錄和計數器的 Game Save。
- 在提供線上遊戲之前偵測連線能力,並透過 GDK 使用者和裝置 API 進行控制器關聯。
需求
- Godot 4.6 或更新版本。 GDK 附加元件是 GDExtension,因此標準組建即可。
- Windows,搭配 Visual Studio 2022 和 Microsoft GDK 版本,用於建置附加元件一次。
- 匯出至 XBOX Series X|S 另外需要 W4 Games 的 Godot 主機分支。
[!NOTE] NetRumble 是採用 MIT 授權的僅限原始碼參考,而非經過認證的遊戲或產品。GDK 和 PlayFab 相依性仍需要各自安裝並接受授權。
開始使用
- XBOX Godot NetRumble: microsoft/xbox-godot-netrumble - 連同子模組一起複製,執行
tools\sync_addons.ps1,然後執行tools\deploy-pc.ps1 -Launch。 - XBOX Godot 範例: XBOX Godot 範例 - NetRumble 所依據的 GDK 和 PlayFab 附加元件,以子模組形式固定版本。
