在 GameMaker 中使用 GDK

• 安装所需软件
• 下载并安装 GameMaker Studio 2
• GameMaker Studio 2 - Microsoft Game Development Kit(GDK)扩展
• 构建 GDK 扩展
• 在 Microsoft Partner Center 中创建产品
• 测试 GDK 扩展
• 更新 MicrosoftGame.config
• 将 GDK 扩展集成到你自己的项目
• 在游戏中测试 XBOX 服务
• 发布

​

安装所需软件

• Visual Studio 2022
• June 2024 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 功能之前,必须调用 gdk_init。
• 在 GDK 处于激活状态期间,每帧调用一次 gdk_update。
• 项目结束、不再需要 GDK 功能时,调用 gdk_quit 清理 GDK。

• Base Module: 提供一组用于控制玩家的用户/账户选择的函数。
• Storage Module: 提供一组用于加载和保存与用户关联数据的函数。
• XBOX services Module: 提供使用 XBOX 服务功能的函数,包括统计、排行榜、成就与富存在。
• In-App Purchases Module: 提供通过 GDK 将 GameMaker 项目与 Microsoft Store 商务系统集成的函数。

​

在游戏中测试 XBOX 服务

​

创建测试账户

​

切换沙箱

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 扩展集成到你的游戏中。