MicrosoftGame.config Element - MSAAppId
指定标题的 MSA 应用 ID,该 ID 与 XBOX Live 标题 ID(如下)一起用于 XBOX Live 服务的标识。自 2022 年 3 月 GDK 起,如果指定了 TitleId 元素,新标题现在需要 MSA 应用 ID。此要求由 MicrosoftGame.config 架构版本更新(从 configVersion 0 到 configVersion 1)强制执行,仅适用于使用 2022 年 3 月及以后 GDK 创建的新标题。父元素
此元素的父元素是 Game 元素。要求
如果 MicrosoftGame.config 中 configVersion = 0,则此元素为可选,无需设置。 如果 MicrosoftGame.config 中 configVersion = 1,则在以下情况下必须设置此元素:- 指定了 TitleId 元素。
- 指定了 NoCodePCRoot 元素。
- AdvancedUserModel 元素设置为 false 值。
平台
此元素适用于 PC 和主机。行为
- 无属性。
- 无默认值。
- 允许值为任何非空字符串。
备注
- MSAAppId 的值通常是 16 个字符的整数字符串。
- MSAAppId 元素是从合作伙伴中心生成的标识 ID。可以在合作伙伴中心项目的 XBOX 服务 -> XBOX 设置选项卡中找到。
- MicrosoftGame.config 中的 MSAAppId 元素必须与合作伙伴中心的值匹配。MicrosoftGame.config 编辑器提供了一个名为 Store Association Wizard 的工具,可自动将本地 .config 中的 MSAAppId(以及其他 Id 值)与合作伙伴中心为你的产品提供的内容同步。
- 如果你的标题使用游戏绑定,MSAAppId 元素的行为会有所不同。有关详细信息,请参阅游戏绑定概述。
- Visual Studio 新项目模板将为此元素提供默认值 ‘PleaseChangeMe’。此值允许你在无需立即从合作伙伴中心获取 Id 的情况下,早期迭代使你的标题编译。强烈建议在标题构建完成后立即更改此 Id,以避免在尝试进行 XUser API 调用时失败。
