搭配 GameMaker 使用 GDK

• 安裝必要軟體
• 下載並安裝 GameMaker Studio 2
• GameMaker Studio 2 - Microsoft Game Development Kit (GDK) 擴充功能
• 建置 GDK 擴充功能
• 在 Microsoft Partner Center 中建立產品
• 測試 GDK 擴充功能
• 更新 MicrosoftGame.config
• 將 GDK 擴充功能整合到您自己的專案中
• 在遊戲中測試 XBOX services
• 發行

​

安裝必要軟體

• Visual Studio 2022
• 2024 年 6 月 GDK 或更新版本
• CMake
  • 確定 CMake 安裝程式會更新系統路徑。否則，擴充功能專案會找不到 CMake。

​

更新 Gaming Runtime Services (GRTS) 和 PC Bootstrapper

​

下載並安裝 GameMaker Studio 2

​

設定 GameMaker Studio 2 GDK 擴充功能

​

建置 GDK 擴充功能

​

在 Microsoft Partner Center 中建立產品

​

測試 GDK 擴充功能

​

更新 MicrosoftGame.config

1. 移至 Partner Center 儀表板。
2. 從產品清單中選取您的遊戲。
3. 選取 Game setup 索引標籤，然後選取 Identity details。
4. 選取 Show Details 以展開 Identity details 區段。
5. 使用 Identity details 區段表格中的下列值。將這些值從 Partner Center 複製到 MicrosoftGame.config 中對應的元素和欄位。

​

MicrosoftGame.config 檔案摘錄範例

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">

  <Identity Name='41336MicrosoftATG.Achievements2017Redux' Version="1.1.0.0" Publisher='CN=A4954634-DF4B-47C7-AB70-D3215D246AF1' />


  <TitleId>64353034</TitleId>
  <MSAAppId>0000000000000000</MSAAppId>

  <ExecutableList>
    <Executable Name="Achievements2017_desktop.exe"
                TargetDeviceFamily="PC"
                Id="Game"/>
  </ExecutableList>

  <ShellVisuals DefaultDisplayName="Achievements2017 Desktop Sample"
                PublisherDisplayName="Xbox Advanced Technology Group"
                StoreLogo="Assets\StoreLogo.png"
                Square150x150Logo="Assets\Logo.png"
                Square44x44Logo="Assets\SmallLogo.png"
                Square480x480Logo="Assets\LargeLogo.png"
                Description="Achievements2017"
                ForegroundText="dark"
                BackgroundColor="#000000"
                SplashScreenImage="Assets\SplashScreen.png"/>
</Game>

​

將 GDK 擴充功能整合到您的專案中

• 呼叫 gdk_init 以初始化 GDK。您必須先呼叫 gdk_init，才能使用任何其他 GDK 功能。
• 在 GDK 作用期間，每個畫面呼叫一次 gdk_update。
• 當您的專案結束且不再需要任何 GDK 功能時，呼叫 gdk_quit 以清除 GDK。

• Base Module： 提供一組函式，用於控制玩家的使用者/帳戶選取。
• Storage Module： 提供一組函式，用於控制與使用者相關聯之資料的載入和儲存。
• XBOX services Module： 提供函式以使用 XBOX services 的功能，包括統計資料、排行榜、成就和 Rich Presence。
• In-App Purchases Module： 提供函式，透過 GDK 將 GameMaker 專案與 Microsoft Store 商務系統整合。

​

在遊戲中測試 XBOX services

​

建立測試帳戶

​

切換沙箱

1. 移至 Partner Center。
2. 若要尋找您的沙箱 ID，請選取 XBOX services，然後選取 Gameplay settings。
   您的沙箱 ID 會顯示在 Gameplay settings 頁面的第一個索引標籤上。其名稱類似 “ABCDEF.0”。
3. 選取 開始 按鈕。
4. 輸入 Microsoft GDK Command Prompts，然後選取 Enter。
5. 開啟第一個命令提示字元，然後輸入 XblPCSandbox.exe <your sandbox ID>。
6. 命令提示字元啟動數個應用程式之後，使用您的測試帳戶登入 XBOX 應用程式。

​

發行您的遊戲

• 在 GameMaker Studio 2 中使用 Package as Zip 建立 MSIXVC 套件。
• 使用您在 Partner Center 中建立之專案的正確值，更新 MicrosoftGame.config 檔案。
• 將 GDK 擴充功能整合到您的遊戲中。