MicrosoftGame.config 元素 - MSAAppId

指定游戏 MSA 应用 ID,它与 Xbox Live 游戏 ID(如下)配合使用,用作 Xbox Live 服务的标识。 自 2022 年 3 月 GDK 起,如果指定了 TitleId 元素,则新游戏现在需要 MSA 应用 ID。 此要求由 MicrosoftGame.config 架构版本更新 (从 configVersion 0 到 configVersion 1) 强制执行,该更新仅适用于使用 2022 年 3 月 GDK 及更高版本创建的新游戏。

父级

此元素的父元素是“游戏”元素。

要求

如果 MicrosoftGame.config 中的 configVersion = 0,则此元素是可选且无需设置。 如果 MicrosoftGame.config 中的 configVersion = 1,则需要在以下情况下设置此元素:

  • 指定了 TitleId 元素。
  • 指定了 NoCodePCRoot 元素。
  • AdvancedUserModel 元素设置为 false 值。

平台

此元素涉及到电脑和主机。

行为

  • 无特性。
  • 没有默认值。
  • 允许的值是任何非空字符串。

备注

  • MSAAppId 的值通常是一个 16 个字符的整数字符串。
  • MSAAppId 元素是从合作伙伴中心生成的标识 ID。 可在 Xbox 服务 -> Xbox 设置选项卡 合作伙伴中心项目中找到此项。
  • MicrosoftGame.config 中的 MSAAppId 元素必须与合作伙伴中心中的值相匹配。 MicrosoftGame.config 编辑器 提供了一个名为“应用商店关联向导”的工具,它将自动将 MSAAppId (和其他 ID 值) 的本地 .config 值与产品在合作伙伴中心中存在的值同步。
  • 如果游戏正在使用游戏绑定,则 MSAAppId 元素的行为会有所不同。 有关详细信息,请参阅游戏绑定概述
  • Visual Studio 新项目模板将为此元素提供默认值‘PleaseChangeMe’。 此值允许提前迭代游戏编译,而无需立即从合作伙伴中心获取 ID。 强烈建议在获取游戏生成后立即更改此 ID,以避免在尝试执行 XUser API 调用时失败。

另请参阅

MicrosoftGame.config 参考 - 目录