> ## 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.

# Xbox 服務沙箱概觀

> 將 XBOX Live 服務設定發佈至開發沙箱，了解沙箱識別碼、測試帳戶，以及如何在 PC 和 XBOX 主機上切換沙箱。

## 為 XBOX 服務開發設定沙箱

在您的遊戲中使用 XBOX 服務之前，您必須在 [Partner Center](https://partner.microsoft.com/dashboard) 中線上設定遊戲的相關資訊。此資訊包括您的遊戲想要顯示的排行榜、玩家可以解除的成就、配對設定等功能。

當您變更服務設定時，必須從 Partner Center 發佈這些變更，XBOX 服務才會採用這些變更。您會發佈至*開發沙箱*，這是一個隔離的環境，您可以在其中處理遊戲而不影響線上版本。

根據預設，XBOX One (或更新版本) 主機和 Windows 10 (及更新版本) PC 位於 **RETAIL** 沙箱中。

如需詳細資訊，另請參閱[進階 XBOX 服務沙箱](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)。

## 本文內容

* [沙箱的優點](#benefits-of-sandboxes)
* [沙箱識別碼](#sandbox-ids)
* [哪些資料會沙箱化？](#what-data-is-sandboxed)
* [測試帳戶](#test-accounts)
* [使用多個沙箱](#using-multiple-sandboxes)
* [在 PC 上設定沙箱](#set-up-your-sandbox-on-pc)
* [在主機上設定沙箱](#set-up-your-sandbox-on-console)

***

## 沙箱的優點

開發沙箱提供數個優點：

* \*\*安全地反覆修改。\*\*您可以變更遊戲的服務設定，而不影響目前可用的版本。
* \*\*工具存取。\*\*基於安全性考量，有些工具只能在開發沙箱中運作。
* \*\*分支您的設定。\*\*您小組中的開發人員可以在個別的沙箱中測試服務設定變更，而不會互相影響。
* \*\*隱私權。\*\*其他發行者在未獲授與您沙箱的存取權之前，無法看到您正在進行的工作。

## 沙箱識別碼

每個沙箱都有唯一且**區分大小寫**的識別碼。開發沙箱遵循以您的發行者代稱為基礎的命名慣例 (例如 `XDKS.1` 或 `XLDP.5`)。

這些稱為沙箱識別碼，在某些情況下也稱為沙箱名稱。

> [!NOTE]
>
> 沙箱識別碼**區分大小寫**。`XDKS.1` 與 `xdks.1` 或 `Xdks.1` 不同。不過，在 PC 上切換沙箱時，**XblPCSandbox.exe** 工具會自動為您更正大小寫。所有沙箱識別碼都是大寫的。請一律以 Partner Center 中的沙箱識別碼為準。

## 哪些資料會沙箱化？

並非所有 XBOX 服務資料都會受到沙箱影響。**沙箱化**的資料會依沙箱隔離，它只存在於建立它的沙箱中，從其他沙箱中無法看到。**未沙箱化**的資料會在所有沙箱 (包括 RETAIL) 之間全域共用。

| 功能 | 沙箱化？ |
| - | - |
| 成就、排行榜和統計資料 | 是 |
| 服務設定 (成就、排行榜、工作階段範本) | 是 |
| 社交資訊 (好友、追蹤者) | 否 |

**重要含意：**

* 在一個沙箱中獲得的成就不會帶到另一個沙箱。
* 不同沙箱中的使用者無法一起配對或玩多人遊戲。
* 發佈至一個沙箱的服務設定在另一個沙箱中看不到。

## 測試帳戶

您可以建立[測試帳戶](https://docs.xbox.com/zh-TW/services/xbox-services/develop/test-accounts/live-test-accounts.md)，以用於開發和測試，而不使用您的個人 XBOX 帳戶。

這是使用沙箱的建議選項。

測試帳戶：

* **只能**登入開發沙箱 (無法登入 RETAIL)。
* 可以獲授與特定沙箱的存取權。
* 可以有**到期日**，您可以在 Partner Center 中檢查和管理。
* 可以有**兒童帳戶**，讓您測試社交互動或多人遊戲等案例。

> [!TIP]
>
> 如果您在使用測試帳戶登入時遇到問題，請參閱[針對登入和沙箱錯誤進行疑難排解](https://docs.xbox.com/zh-TW/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)一節以取得更多詳細資料。

如需詳細資訊，另請參閱[測試帳戶](https://docs.xbox.com/zh-TW/services/xbox-services/develop/test-accounts/live-test-accounts.md)。

## 使用多個沙箱

多個沙箱適用於更進階的案例：

* \*\*服務設定隔離。\*\*使用*開發*沙箱進行積極開發，並為您的 QA 小組使用*測試*沙箱。您發佈至*開發*的變更不會影響測試人員看到的內容。
* \*\*多人遊戲隔離。\*\*將開發人員和測試人員放在不同的沙箱中，這樣在測試期間配對就不會混合這兩個群組。

> [!NOTE]
>
> 如果您參與 **XBOX Creators Program**，則只能有一個沙箱。若要建立多個沙箱，您必須參與**受管理的合作夥伴計畫**。

如需沙箱隔離、產品執行個體和多組織案例的詳細資料，請參閱[進階 XBOX 服務沙箱](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)。

## 沙箱如何融入您的工作流程

以下是使用沙箱時的典型工作流程：

1. **將您的裝置切換**至您的開發沙箱。視您計劃設定的環境而定，請參閱下方的 [PC](#set-up-your-sandbox-on-pc) 或[主機](#set-up-your-sandbox-on-console)指示。
2. 在反覆修改服務設定時，**將變更發佈**至您的開發沙箱。
3. 與需要在同一個沙箱中工作的小組成員**共用存取權**。
4. 當您需要在零售環境中測試、更新系統應用程式或玩其他遊戲時，**切換回 RETAIL**。

***

## 在 PC 上設定沙箱

### 使用 XblPCSandbox.exe 切換沙箱 (建議)

**XblPCSandbox.exe** 是 GDK 隨附的命令列工具。這是在 PC 上切換沙箱的建議方式。

如需如何使用 XblPCSandbox.exe 及其各自引數的詳細資訊，請參閱 [XBOX Live PC 沙箱切換器 (XblPCSandbox.exe)](https://docs.xbox.com/zh-TW/tools/tools-services/live-pc-sandbox-switcher.md)

***

## 在主機上設定沙箱

本節說明如何將您的 XBOX One (或更新版本) 主機切換至開發沙箱，以便使用 XBOX 服務測試您的遊戲。

### 使用 XBOX Device Portal

您可以使用 XBOX Device Portal 變更主機上的沙箱。若要執行此動作，請前往主機上的 "Dev Home" 並將其啟用。

之後，您可以在 PC 的網頁瀏覽器中輸入 IP 位址以連線至您的主機。然後，您可以選取 **XBOX Live** 並在該處的文字方塊中輸入沙箱。

### 使用 XBOX Manager

XBOX Manager 適用於 XBOX One 或更新版本的主機。

XBOX Manager 可讓您從 PC 管理主機的特定層面。這包括重新啟動、管理已安裝的應用程式，以及變更沙箱。

以滑鼠右鍵按一下您要變更沙箱的主機，然後前往 **Settings...**

然後您可以在該處輸入沙箱。

### 使用 XBOX 主機 UI

如果您想要直接從 XBOX One (或更新版本) 主機變更開發沙箱，可以前往 **Settings**。然後前往 **Developer Settings**，您會看到變更沙箱的選項。

***

## 後續步驟

如果您在切換沙箱時遇到任何問題，請前往[針對登入和沙箱錯誤進行疑難排解](https://docs.xbox.com/zh-TW/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)，以取得引導式診斷程序和錯誤碼參考。

## 另請參閱

* [進階沙箱概念概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/sandboxes/live-advanced-sandboxes.md)
* [測試帳戶](https://docs.xbox.com/zh-TW/services/xbox-services/develop/test-accounts/live-test-accounts.md)
* [針對登入和沙箱錯誤進行疑難排解](https://docs.xbox.com/zh-TW/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)
* [XblPCSandbox.exe 參考](https://docs.xbox.com/zh-TW/tools/tools-services/live-pc-sandbox-switcher.md)
* [XBOX 服務設定概觀](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md)
* [MicrosoftGame.config 概觀](https://docs.xbox.com/zh-TW/build/core-features/common/game-config/MicrosoftGameConfig-Overview.md)


## Related topics

- [沙箱](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-advanced-sandboxes.md)
- [XBOX 服務設定的摘要頁面](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/portal-config/live-portal-summary-tab.md)
- [針對 XBOX 服務登入進行疑難排解](https://docs.xbox.com/zh-TW/services/xbox-services/fundamentals/identity/auth/live-troubleshooting-sign-in.md)
- [PC 沙箱切換器 (XblPCSandbox.exe)](https://docs.xbox.com/zh-TW/tools/tools-services/live-pc-sandbox-switcher.md)