GDK 可下载内容 (DLC) 包

Microsoft 游戏开发工具包(GDK)的可下载内容(DLC)包是与主游戏分开的独立包。DLC 包会独立于游戏其余部分单独出售和下载,或作为购买捆绑包的一部分。创建、发布和使用 DLC 包的流程在概念上与 XBOX One 主机游戏相同,但部分打包文件格式和运行时 API 已更新,使用起来更为简单。 DLC 包在 PC 上使用相同的打包结构支持,并且在主机和 PC 上使用相同的运行时 API 进行访问。对于 XBOX Series X|S 与 XBOX One 主机,可以生成一个可用于两种平台的 DLC 包桩文件(stub)。如果 DLC 包中包含真正的内容差异,请使用 TargetDeviceFamilyForDLC 元素生成特定平台的 DLC 包。

设置主包的标识

在主游戏产品的 Game Setup 页面中查找主应用包的 Store ID(12 个字符的字母数字字符串)。(示例:9PNX12345AAA)
将 StoreId 元素添加到主包的 MicrosoftGame.config 文件中。

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    <!-- Content omitted for brevity. -->
    <StoreId>**REPLACE WITH STOREID**</StoreId>
</Game>

创建 DLC 包

在 Partner Center 中的主产品下,通过 Add-Ons 菜单创建你的 DLC 包附加项。
将所有 DLC 包内容放入单个目录。
在与 DLC 包内容相同的目录中,使用下面的示例数据创建一个 MicrosoftGame.config 文件。
在 TargetDeviceFamilyForDLC 字段中指定该 DLC 包所面向的 Target Device Family。允许的值为 XBOX One、XBOX Series X|S 或 PC。对于 XBOX One 和 XBOX Series X|S 是必需的;对于 PC 而言,只要在使用 makepkg.exe 生成 DLC .MSIXVC 文件时使用了 /pc 标志,则为可选。
在 Partner Center 的 Game Setup 页面中查找主应用包的 Package/Identity/Name 字段,然后将该 Identity Name 填入 MainPackageDependency 字段。例如,MyPackageName
从 Partner Center 中查找你的附加项/DLC 包的 Store ID(12 个字符的字母数字字符串),然后将其放入 StoreId 字段,如下所示。
在主游戏产品的 Game Setup 页面中查找主应用包的 Store ID(12 个字符的字母数字字符串)。将其放入 AllowedProduct 字段中,如下所示。例如,9PNX12345AAA

<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    <Identity Name="**REPLACE**"
        Publisher="**REPLACE**"
        Version="1.0.0.0"/>
    <ShellVisuals DefaultDisplayName="**REPLACE**"
                  PublisherDisplayName="**REPLACE**"
                  StoreLogo="Storelogo.png"
                  Square150x150Logo="Logo.png"
                  Square44x44Logo="SmallLog.png"
                  Description="**REPLACE**"
                  BackgroundColor="#000040"
                  SplashScreenImage="SplashScreen.png"/>
    <StoreId>**REPLACE WITH STOREID OF ADD-ON / DLC**</StoreId>
    <TargetDeviceFamilyForDLC>**REPLACE**</TargetDeviceFamilyForDLC>
    <AllowedProducts>
      <AllowedProduct>**REPLACE WITH STOREID OF BASE GAME**</AllowedProduct>
    </AllowedProducts>

<!-- The Desktop Registration section is for PC only. -->
    <DesktopRegistration>
      <MainPackageDependency Name="**REPLACE_WITH_IDENTITY_OF_PARENT_PRODUCT**" />
      <ProcessorArchitecture>x64</ProcessorArchitecture>
    </DesktopRegistration>
</Game>

在包含单个游戏内容文件夹的目录中,打开 Microsoft 游戏开发工具包(GDK)命令提示符,然后运行以下命令。

MakePkg genmap /f layout.xml /d <Your_dlc_folder>

如果你在为 PC 创建 DLC,请使用以下命令。

MakePkg pack /f layout.xml /lt /d <Your_dlc_folder_name> /pc /pd <Output_Folder_Name>

如果你在为主机创建 DLC,请使用以下命令。

MakePkg pack /f layout.xml /lt /d <Your_dlc_folder_name> /pd <Output_Folder_Name> 在早期的 SDK 中,你会在命令行上使用 /ProductID 标志传递主游戏的 Product ID GUID。在使用 MicrosoftGame.Config 模型配置 DLC 包关系时,请不要使用 /ProductID 参数。MakePkg 会根据你 MicrosoftGame.config 文件中列出的 StoreID 自动将适当的信息放入你的包中。

在游戏运行时访问 DLC 包

在 DLC 包中使用内容的基本步骤如下。

枚举包
检查目标包的有效用户许可证
从枚举结果中获取 packageIdentifier,并将其传递给 XPackageMount API。

在 XBOX Series X|S 主机上,除非你在 MicrosoftGame.config 中为 DlcCompatibility 字段指定 XboxOne,否则只能使用 TargetDeviceFamilyForDLC 为 XBOX Series X|S 的 DLC 包:

    <VirtualMachine>
        <DlcCompatibility>XboxOne</DlcCompatibility>
    </VirtualMachine>

XBOX Series X|S DLC 只能安装在快速存储上,而 XBOX One DLC 没有此类限制,因此在选择加入之前请务必考虑这一点。

部署和测试 DLC 包

请务必在安装 DLC 包之前安装主游戏包。对于 XBOX 主机,使用以下命令安装 DLC 包。 xbapp install <Your_DLC_Package.xvc> 对于 PC,使用以下命令安装 DLC 包。 wdapp install <Your_DLC_Package.msixvc> DLC 内容也可以从包含松散文件的目录注册,并且可以使用从 Microsoft Store 下载的包进行测试。有关详细信息,请参见 Manage and license downloadable content。

参考 API 文档

XPackage(API 内容)
- Functions
  - xpackageenumeratepackages
  - XPackageMount

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

设置主包的标识

创建 DLC 包

在游戏运行时访问 DLC 包

部署和测试 DLC 包

参考 API 文档

​设置主包的标识

​创建 DLC 包

​在游戏运行时访问 DLC 包

​部署和测试 DLC 包

​参考 API 文档

设置主包的标识

创建 DLC 包

在游戏运行时访问 DLC 包

部署和测试 DLC 包

参考 API 文档