跳轉到主要內容

概觀

本主題說明如何取得設定沙箱所需的識別碼,以及如何設定您的應用程式以使用 XBOX 服務。 沙箱為個別開發套件提供內容隔離,為開發和測試提供乾淨的環境。 XBOX 服務提供線上功能,例如事件、成就和多人遊戲功能。 若要啟用沙箱並使用 XBOX 服務,您需要取得數個識別碼來設定您的開發套件和遊戲。 這些都可以透過相同的程序完成。 程序如下。
  1. 取得您的識別碼。
  2. 在您的開發套件上設定沙箱。
  3. 將 TitleID 與其他選擇性識別碼一起繫結至您的遊戲。

重要識別碼

有三個識別碼對於開發 XBOX One (或更新版本) 的遊戲和應用程式至關重要:沙箱識別碼、TitleID 和服務設定識別碼 (SCID)。 雖然使用開發套件必須擁有沙箱識別碼,但 TitleID 和 SCID 不是初始開發所必需的,不過任何 XBOX 服務的使用都需要它們。 因此,建議您同時取得全部三個識別碼。

沙箱識別碼

沙箱會在開發期間為您的開發套件提供內容隔離,確保您擁有一個乾淨的環境來開發和測試您的遊戲。 沙箱識別碼可識別您的沙箱。 一部主機在任何時間只能存取一個沙箱,不過一個沙箱可以由多部主機存取。 沙箱識別碼會區分大小寫。

TitleID

TitleID 可向 XBOX 服務唯一識別您的遊戲。 TitleID 在整個服務中使用,讓您的使用者能夠存取您遊戲的 XBOX 內容、他們的使用者統計資料和成就等,並啟用 XBOX 多人遊戲功能。 視其使用方式和位置而定,遊戲識別碼可能會區分大小寫。

服務設定識別碼 (SCID)

作為開發的一部分,您將建立事件、成就和許多其他線上功能。 這些都是服務設定的一部分,需要 SCID 才能存取。 與先前版本的 XBOX OS 不同,為 Microsoft GDK 遊戲 OS 開發的遊戲只有單一 SCID,因此特定沙箱內遊戲的所有執行個體都共用相同的設定。 Microsoft GDK 遊戲 OS 的 SCID 一律是 GUID,其值與 TitleID 相同,並在前面加上零。 對於 Microsoft Game Development Kit (GDK) 遊戲與 XBOX 服務的絕大多數互動,不再需要明確指定 SCID,但如果直接與 XBOX 服務 REST 端點互動,則可能需要指定。 SCID 會區分大小寫。

取得您的識別碼

目前,您將透過與開發人員客戶經理合作來取得您的識別碼。

設定沙箱

如果不設定沙箱識別碼,您將無法啟動開發套件。 若要執行此動作,請開啟 GDK 命令視窗,並依下列方式使用 Configuration (xbconfig.exe) (NDA 主題) 命令。
  1. 檢查您目前的沙箱。在命令提示字元中輸入 xbconfig sandboxid。
  2. 如果不是您預期的沙箱,請變更您的沙箱識別碼。在命令提示字元中輸入 xbconfig sandboxid=<your sandbox id>。
  3. 在命令提示字元中使用 Reboot (xbreboot.exe) (NDA 主題) 重新啟動您的主機。
  4. 確認您的沙箱已正確重設。在命令提示字元中輸入 xbconfig sandboxid。

將 TitleID 和其他選擇性識別碼新增至您的二進位檔

雖然沙箱是在平台層級為每個開發套件設定的,但 TitleID 會繫結至特定的二進位檔。 若要將 TitleID 新增至您的二進位檔,請在該二進位檔的 MicrosoftGame.config 檔案中,於 <Game> 節點中新增節點,如下所示。
自 2022 年 3 月版 Microsoft Game Development Kit (GDK) 起,如果在 MicrosoftGame.config 中指定了 MSAAppId 或 TitleId 其中之一,則兩者都是必要的。如需詳細資訊,請參閱 MicrosoftGame.config 元素 - MSAAppId 和 MicrosoftGame.config 元素 - TitleId。

RequiresXboxLive 旗標

如果 RequiresXboxLive 旗標設定為 true,除非有與 XBOX 網路的作用中連線,且遊戲通過 XBOX 服務的驗證,否則遊戲不會啟動。 這可確保遊戲已取得最新的內容更新。 如果遊戲執行時連線中斷,遊戲會被暫停,然後終止。 只有「需要網際網路」的遊戲才應將 RequiresXboxLive 標記為 true。請注意,以這種方式標記您的遊戲,並不保證遊戲所需的服務已啟動且正在執行。 RequiresXboxLive 同樣是 MicrosoftGame.config 檔案中 Game 下的節點。
最後修改於 2026年10月16日