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

# 正确切换沙盒以进行 Store 操作

> 在 PC 上使用 Xblpcsandbox.exe 正确切换 Microsoft Store 操作的沙盒，让 XBOX 用户注销并更新商店范围。

你可以通过多种方式在 PC 上切换沙盒。请使用 `Xblpcsandbox.exe`，因为它会在沙盒更改时注销任何登录到启用 XBOX 服务的应用的账号。

对于 XBOX 服务操作，只需使用已配置到新切换沙盒的账号登录即可，类似于在零售环境中使用不同账号登录。登录后，`XUser` 上下文会理解当前沙盒。

Store 操作需要 XBOX 用户登录到启用 XBOX 服务的应用，以将产品浏览和购买范围限定到某个沙盒。仅在 Microsoft Store 应用中登录账号会将沙盒范围默认为零售（或如果之前设置过则为先前的沙盒）。

> [!NOTE]

因此，在切换沙盒后 **首先** 登录 XBOX 服务非常重要：

1. 在 GDK 命令提示符中：`xblpcsandbox` \<sandbox id>
2. 在 XBOX 应用中使用已配置到该沙盒的账号登录
3. 在 Microsoft Store 应用中使用相同账号登录

> [!NOTE]
>
> XBOX 应用可能会弹出对话框，询问是否将商店账号切换为新登录的账号。

在沙盒中不要依赖此机制。始终显式地使用测试账户登录 Microsoft Store 应用。

商店账号也可以与 XBOX 账户不同。有关更多信息，请参阅[在 PC 上处理商店账号不匹配的场景](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-mismatched-accounts.md)。

在涉及沙盒的所有过渡后执行这些步骤：

* 从零售切换到沙盒
* 从一个沙盒切换到另一个沙盒
* 从沙盒切换到零售

未能正确切换账号最常见的问题是：在 XBOX 服务登录 **之后** 未登录商店账号，导致所有商店操作返回错误结果。

> [!NOTE]
>
> 在开发沙盒中测试商务时，请确保单个测试账户上的所有购买都在同一个沙盒中完成。

将测试账户切换到另一个沙盒并购买更多物品会导致两个沙盒中该账号的查询结果异常。此行为的发生是因为购买的许可证和信息与单个账号首次购买该物品时所在的沙盒绑定。

## XBOX 应用优化

XBOX 应用的菜单中有一个指示器显示当前活动的沙盒：

![XBOX 应用沙盒指示器](https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/xboxapp-sandboxindicator.png?fit=max\&auto=format\&n=iADzli99B7EWodAv\&q=85\&s=08e656f9274149823494ff146edad0ed)

当 PC 正确配置为开发沙盒，并且登录 XBOX 应用的测试账户具有对该沙盒的访问权时，该指示器就会出现。

使用 XBOX 应用还有一个额外的好处：应用可以自动尝试协调商店账号。因此，如果你停留在 XBOX 应用中，目录、购买操作和所有权应反映相同的账号并处于该沙盒中。

## 游戏内商店操作（使用 `XStore` API）

游戏获得的 `XStoreContext` 是商店账号的上下文，无论是显式地在 Microsoft Store 应用中登录，还是作为 XBOX 应用登录的一部分完成的。`XStore` API 使用哪个账号最好的判断方式是查看 XBOX 应用用于其商店操作的账号。

## 另请参阅

XBOX Live PC Sandbox Switcher

XBOX 服务沙盒概览

排查登录错误

[启用 XStore 开发与测试](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-product-testing-setup.md)


## Related topics

- [Partner Center 的初始配置](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-initial-configuration.md)
- [启用授权测试](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-licensing-setup.md)
- [启用 XStore 开发与测试](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-product-testing-setup.md)
- [PC 上的 XStore — DRM、许可证令牌和沙盒](https://docs.xbox.com/zh-CN/publishing/xstore-commerce/xstore-pc.md)
- [登录和沙盒错误故障排除](https://docs.xbox.com/zh-CN/services/xbox-services/develop/troubleshooting/live-troubleshoot-sandboxes.md)