> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 設定沙箱

> 如何從 Partner Center 取得沙箱識別碼、TitleID 和 SCID，並設定 XBOX 開發套件沙箱，以為您的遊戲啟用 XBOX Live 服務。

## 概觀

本主題說明如何取得設定沙箱所需的識別碼，以及如何設定您的應用程式以使用 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 主題)](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconfig.md) 命令。

1. 檢查您目前的沙箱。在命令提示字元中輸入 **xbconfig sandboxid**。
2. 如果不是您預期的沙箱，請變更您的沙箱識別碼。在命令提示字元中輸入 **xbconfig sandboxid=\<*your sandbox id*>**。
3. 在命令提示字元中使用 [Reboot (xbreboot.exe) (NDA 主題)](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbreboot.md) 重新啟動您的主機。
4. 確認您的沙箱已正確重設。在命令提示字元中輸入 **xbconfig sandboxid**。

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

雖然沙箱是在平台層級為每個開發套件設定的，但 TitleID 會繫結至特定的二進位檔。
若要將 TitleID 新增至您的二進位檔，請在該二進位檔的 [MicrosoftGame.config](https://docs.xbox.com/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-toc.md) 檔案中，於 `<Game>` 節點中新增節點，如下所示。

```xml theme={null}
<?xml version="1.0" encoding="utf-8"?>
<Game configVersion="1">
    ...
    <TitleId>yourTitleId</TitleId>
    <StoreId>yourStoreId</StoreId>
    <MSAAppId>yourMSAAppId</MSAAppId>
    ...
</Game>  
```

> [!NOTE]
>
> 自 2022 年 3 月版 Microsoft Game Development Kit (GDK) 起，如果在 MicrosoftGame.config 中指定了 MSAAppId 或 TitleId 其中之一，則兩者都是必要的。如需詳細資訊，請參閱 [MicrosoftGame.config 元素 - MSAAppId](https://docs.xbox.com/zh-TW/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-msaappid.md) 和 [MicrosoftGame.config 元素 - TitleId](https://docs.xbox.com/zh-TW/reference/system/microsoftgameconfig/elements/microsoftgameconfig-element-titleid.md)。

## RequiresXboxLive 旗標

如果 **RequiresXboxLive** 旗標設定為 true，除非有與 XBOX 網路的作用中連線，且遊戲通過 XBOX 服務的驗證，否則遊戲不會啟動。
這可確保遊戲已取得最新的內容更新。
如果遊戲執行時連線中斷，遊戲會被暫停，然後終止。

只有「需要網際網路」的遊戲才應將 **RequiresXboxLive** 標記為 true。請注意，以這種方式標記您的遊戲，並不保證遊戲所需的服務已啟動且正在執行。
**RequiresXboxLive** 同樣是 [MicrosoftGame.config](https://docs.xbox.com/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-toc.md) 檔案中 `Game` 下的節點。


## Related topics

- [PC 沙箱切換器 (XblPCSandbox.exe)](https://docs.xbox.com/zh-TW/tools/tools-services/live-pc-sandbox-switcher.md)
- [沙箱](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/index.md)
- [Xbox 服務沙箱概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)
- [進階 XBOX 服務沙箱](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
- [在 Partner Center 中設定 XBOX 產品](https://docs.xbox.com/zh-TW/publishing/game-publishing/publishing-processes/managed-creators/publishing-processes-product-onboarding-and-configuration.md)