跳转到主要内容
本主题介绍如何创建跨代测试光盘,以便你在 XBOX One 家族主机和 XBOX Series 主机上测试你的游戏。
这些说明仅用于测试目的。对于零售场景,此数据会根据 Partner Center 中的元数据自动配置。创建编译光盘流程中所选选项用于控制诸如安装顺序和自动播放等设置。在向 Microsoft 提交游戏进行接收时,你无需提交测试元数据或 JSON 配置文件。
可以创建以下类型的测试光盘。

创建 Smart Delivery 光盘

Smart Delivery 光盘包含一个用于 XBOX One 家族主机的包和一个用于 XBOX Series 主机的包。这两个包共用一个可对两者生效的许可证。它们在 Partner Center 中属于同一产品。插入主机时,会安装适合该主机类型的包,并在可用时启动任何相应的内容更新。
如果你希望通过在光盘上使用独立的 Partner Center 产品来为每个主机世代分别创建游戏包,则称为多产品光盘。有关详细信息,请参阅本主题中的多产品光盘一节。

创建并测试 Smart Delivery 光盘

要创建并测试 Smart Delivery 光盘,请按本主题以下各节中所述创建 catalog.js 元数据文件和光盘布局。

创建光盘布局

创建如下所示的光盘布局。
Package_x.xvc 和 Package_xs.xvc 是按主机世代划分的包。MakePkg 工具会为包添加后缀:XBOX One 包为 _x,XBOX Series X|S 世代包为 _xs。在 catalog.js 文件中,其中一个包被声明为另一个包的“variant”。在上例中,Package_xs.xvc 是 Package_x.xvc 的变体。 各目录包含以下内容:
  • Licenses 包含游戏的许可证文件。XBOX One ERA 开发工具包不需要此信息。请使用带 /LT 或 /LK 标志创建的 XVC,之后可省略这些文件。
如果你使用带 /LK 标志创建的包,则需要使用 xbapp installkey 将 CEKB 文件安装到目标主机,以便解密光盘上的 /LK 包。有关详细信息,请参阅 xbapp.exe(NDA 主题)。
  • MSXC 包含已打包的游戏及 XBOX 外壳使用的元数据。
  • Metadata 包含 shell 用于光盘上的游戏以及游戏包的元数据。
  • Package_x.xvc 包含 shell 用于该游戏的图像。名称必须与 MSXC 中的游戏包文件匹配。对于作为其他包变体的包,无需提供图像。

Catalog.js

在 Metadata 文件夹中,创建名为 catalog.js 的文件。编辑此文件以反映其他文件夹中包和图像的名称。
此文件必须使用 UTF-8 编码。我们建议使用网页上的 JSON 校验工具。为确保 JSON 校验有效,请将其复制到文本编辑器中,然后以 UTF-8 格式保存文件。

Smart Delivery 产品示例

以下是使用 Smart Delivery 的单个产品的 catalog.js 文件示例,含内联注释。

多产品光盘

多产品光盘包含一个用于 XBOX One 主机的包和一个用于 XBOX Series X|S 主机的包。光盘为每个包分别包含一个许可证。这些包来自 Partner Center 中不同的产品,通过 Partner Center 中配置的显式世代关系相互关联。当它们作为数字捆绑包出售,或通过光盘安装到主机时,默认只安装其中一个包。将光盘插入主机时,会安装适合该主机类型的包,并在可用时启动任何相应的内容更新。
如果你希望使用单个 Partner Center 产品为每个主机世代分别创建包,则称为跨代 Smart Delivery 光盘。有关详细信息,请参阅本主题的 Smart Delivery 一节。

多产品光盘示例

以下是多产品光盘的 catalog.js 文件示例,含内联注释。

另请参阅

创建光盘 创建测试光盘 多光盘功能
最后修改于 2026年10月9日