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

# 正確切換沙箱以進行市集作業

> 使用 Xblpcsandbox.exe 在 PC 上正確切換沙箱以進行 Microsoft Store 作業，讓 XBOX 使用者登出並更新市集範圍。

您可以透過多種方式在 PC 上切換沙箱。請使用 `Xblpcsandbox.exe`，因為它會在沙箱變更時，將已登入啟用 XBOX services 之應用程式的所有帳戶登出。

對於 XBOX services 作業，只要使用已佈建至新切換之沙箱的帳戶登入即可，這類似於在零售環境中使用不同帳戶登入。登入之後，`XUser` 內容就會了解目前的沙箱。

市集作業需要有 XBOX 使用者登入啟用 XBOX services 的應用程式，才能將產品的瀏覽和購買範圍限定在某個沙箱。若只是在 Microsoft Store 應用程式中使用帳戶登入，沙箱範圍會預設為零售 (如果先前曾設定沙箱，則為先前的沙箱)。

<Info />

因此，切換沙箱之後，**務必先**登入 XBOX services：

1. 從 GDK 命令提示字元：`xblpcsandbox` \<sandbox id>
2. 使用已為沙箱佈建的帳戶登入 XBOX 應用程式
3. 使用相同帳戶登入 Microsoft Store 應用程式

<Note>
  XBOX 應用程式可能會彈出對話方塊，詢問是否要將市集帳戶切換為新登入的帳戶。
</Note>

在沙箱中請勿依賴此機制。請一律在 Microsoft Store 應用程式上明確使用測試帳戶登入。

市集帳戶也可以是與 XBOX 帳戶不同的帳戶。如需詳細資訊，請參閱[處理 PC 上市集帳戶不相符的情況](/zh-TW/publishing/xstore-commerce/xstore-mismatched-accounts)。

在所有涉及沙箱的轉換之後執行這些步驟：

* 從零售切換至沙箱
* 從一個沙箱切換至另一個沙箱
* 從沙箱切換至零售

未正確切換帳戶時最常見的問題是，市集帳戶並未在 XBOX services 登入**之後**登入，導致所有市集作業都傳回不正確的結果。

<Note>
  在開發沙箱中測試商務功能時，請確定單一測試帳戶上的所有購買都在同一個沙箱中進行。
</Note>

將測試帳戶切換至另一個沙箱並購買更多項目，會導致該帳戶在兩個沙箱中都產生非預期的查詢結果。發生此行為的原因是，對於單一帳戶，購買的授權和資訊會繫結至最初購買該項目的沙箱。

## XBOX 應用程式最佳化

XBOX 應用程式的功能表中有一個指示器，會顯示目前作用中的沙箱：

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/xboxapp-sandboxindicator.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=08e656f9274149823494ff146edad0ed" alt="XBOX 應用程式沙箱指示器" width="937" height="545" data-path="images/xstore/xboxapp-sandboxindicator.png" />

當 PC 已正確設定為開發沙箱，且登入 XBOX 應用程式的測試帳戶可存取該沙箱時，就會顯示此指示器。

使用 XBOX 應用程式的額外好處是，應用程式可以自動嘗試協調市集帳戶。因此，如果您停留在 XBOX 應用程式內，目錄、購買作業和擁有權應該都會反映相同的帳戶，且位於該沙箱中。

## 遊戲內市集作業 (使用 `XStore` API)

遊戲取得的 `XStoreContext` 是市集帳戶的內容，無論該帳戶是在 Microsoft Store 應用程式上明確登入，還是在 XBOX 應用程式登入過程中登入。要判斷 `XStore` API 使用哪個帳戶，最好的指標就是 XBOX 應用程式用於其市集作業的帳戶。

## 另請參閱

XBOX Live PC 沙箱切換器

XBOX services 沙箱概觀

針對登入錯誤進行疑難排解

[啟用 XStore 開發和測試](/zh-TW/publishing/xstore-commerce/xstore-product-testing-setup)


## Related topics

- [認證 PC BVT 指南](/zh-TW/publishing/game-publishing/concepts/certification/certification-pc-bvt-guide.md)
- [認證主機 BVT 指南](/zh-TW/publishing/game-publishing/concepts/certification/certification-console-bvt-guide.md)
- [GDK 名詞與縮寫詞彙表](/zh-TW/home/glossary.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [存取 GDK 資源與下載](/zh-TW/home/onboarding-access/access-resources.md)