Skip to main content

MicrosoftGame.config 元素 - MSAAppId

指定遊戲的 MSA 應用程式識別碼,此識別碼會與 XBOX Live 遊戲識別碼 (如下所示) 搭配使用,以向 XBOX Live 服務進行身分識別。自 2022 年 3 月 GDK 起,若已指定 TitleId 元素,新遊戲現在必須提供 MSA 應用程式識別碼。此需求是透過 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 元素是從 Partner Center 產生的身分識別碼。您可以在 Partner Center 專案的 XBOX 服務 -> XBOX 設定索引標籤中找到。
  • 您 MicrosoftGame.config 中的 MSAAppId 元素必須與 Partner Center 中的值相符。MicrosoftGame.config 編輯器提供名為「市集關聯精靈」的工具,可自動將 MSAAppId (及其他識別碼值) 的本機 .config 值與您產品在 Partner Center 中的值同步。
  • 若您的遊戲使用遊戲繫結,MSAAppId 元素的行為會有所不同。如需詳細資訊,請參閱遊戲繫結概觀。
  • Visual Studio 新專案範本會為此元素提供預設值 ‘PleaseChangeMe’。此值可讓您在早期反覆開發時編譯遊戲,而不必立即從 Partner Center 取得識別碼。強烈建議您在遊戲可以建置後立即變更此識別碼,以避免嘗試進行 XUser API 呼叫時失敗。

另請參閱

MicrosoftGame.config 參考 - 目錄
Last modified on October 6, 2026