> ## 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.com/play 上的 Web 内容测试应用 (CTA)

> 介绍如何在 xbox.com/play 上使用 Web 内容测试应用开发者工具。

Web 内容测试应用 (CTA) 开发者工具可在 [xbox.com/play](https://www.xbox.com/play) 上使用，这是当前的 XBOX Cloud Gaming Web 体验。这些工具设计用于 Windows 上的 Edge 和 Chrome，以及 Mac、iOS 和 iPadOS 上的 Safari。

本文介绍 xbox.com/play。一种新体验正在 [play.xbox.com](https://play.xbox.com/) 上提供预览。若要使用其开发者工具，请参阅 [Web 内容测试应用 (CTA) 概述](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-web-content-test-application.md)。

* [选择体验](#choose-an-experience)
* [打开开发者工具](#open-developer-tools)
* [选择产品](#select-an-offering)
* [IP Connect](#ip-connect)
* [Remote Connect](#remote-connect)
* [开发者设置](#developer-settings)
* [TAK 旁加载](#tak-sideload)
* [在串流期间切换 TAK 布局](#switch-tak-layouts-during-a-stream)
* [鼠标和键盘](#mouse-and-keyboard)
* [试用新体验](#try-the-new-experience)

## 选择体验

Web CTA 可在两种 XBOX Cloud Gaming Web 体验上运行：xbox.com/play 和处于预览阶段的 play.xbox.com。请使用下表为你的场景选择一种体验：

| 场景 | xbox.com/play | play.xbox.com |
| :- | :- | :- |
| 通过 IP Connect 连接到 XBOX 开发工具包 | 仅支持沙盒测试帐户 | 支持 |
| 从同一台 PC 进行 TAK 旁加载 | 支持 | 支持 |
| 从 PC 向手机或平板电脑进行 TAK 旁加载 | 通过 HTTPS 支持 | 暂不支持 |
| 在串流期间切换布局 | 支持 | 支持 |
| Remote Connect | 支持 | 支持 |

两种体验均支持私有产品、沙盒测试帐户、区域选择以及鼠标和键盘。

## 打开开发者工具

要开始使用开发者工具，请访问 [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools)。如果你尚未登录，该页面会要求你登录，并包含一个沙盒字段。

* 对于零售帐户，请将沙盒留空，并使用已登录到 XBOX 开发工具包或已配置为可访问私有产品的同一帐户登录。
* 对于沙盒测试帐户，请在登录前输入沙盒 ID。

沙盒是供你的游戏使用的隔离开发环境，每个沙盒测试帐户都属于一个沙盒。沙盒 ID 并不是你的产品 ID；请向创建测试帐户的人员获取。有关详细信息，请参阅 [XBOX 服务沙盒概述](https://docs.xbox.com/zh-CN/services/xbox-services/fundamentals/sandboxes/live-setup-sandbox.md)。

> [!NOTE]
>
> 如果你在没有沙盒 ID 的情况下登录沙盒测试帐户，某些功能可能无法正常工作，因为这些帐户无权访问零售功能。

如果你在未提供沙盒 ID 的情况下登录，请访问另一个 Microsoft 网站（例如 [outlook.com](https://www.outlook.com)）以注销。然后使用正确的沙盒 ID 重新登录。

你也可以从 xbox.com/play 目录中打开开发者设置。选择你的个人资料图片，然后选择 **Settings** > **Developer**。如果未显示 **Developer**，请快速连续选择 **Account** 10 次以显示它。在开发者设置中，选择 **Developer Tools Home** 可返回开发者工具页面。

> [!NOTE]
>
> 在 iOS 或 iPadOS 上，你可以将该页面保存为渐进式 Web 应用 (PWA)。选择共享按钮，然后选择 **Add to Home Screen**。
>
> PWA 会记住你的帐户和配置，以便你稍后返回继续测试。

## 选择产品

产品是用于验证在数据中心硬件上运行的游戏的私有测试环境。有关产品的详细信息，请参阅[游戏串流概述](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-overview.md#what-are-private-offerings)。

要使用特定产品：

1. 转到 [xbox.com/play/dev-tools/select-offering](https://www.xbox.com/play/dev-tools/select-offering)。
2. 从下拉列表中选择产品，或选择 **Custom offering ID** 并在 **Enter offering ID for cloud connection** 中输入产品 ID。
3. 选择 **Connect**。

此时会打开你的产品目录，页面上会显示 **Using custom offering**，后跟产品 ID。如果无法访问该产品，请确保你登录的帐户已获得使用该特定产品的授权。

### 产品区域

产品不会自动将你路由到最近的数据中心。若要在其他区域进行测试，请打开 **Settings** > **Developer**，并在 **Streaming Region** 下选择一个区域。请在开始串流之前进行选择。**Current region** 会显示你的选择。可用区域必须预先配置。请联系你的 Microsoft 客户代表，以调整你的产品可用的区域。

## IP Connect

使用 IP Connect 可通过 IP 地址直接从 XBOX 开发工具包进行串流。在 xbox.com/play 上，IP Connect 需要沙盒测试帐户，并且开发者工具页面不提供指向它的链接。

使用 IP Connect 之前，请完成以下先决条件：

1. 设置 XBOX 开发工具包以进行串流。有关详细信息，请参阅[设置 XBOX 开发工具包](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-setup-xbox-developer-kit.md)。
2. 在 **Dev Home** > **Streaming** 中，确保 **Direct Connect** 正在侦听。每次开发工具包重启后，它都会停止侦听。
3. 确保你的客户端设备与 XBOX 开发工具包位于同一网络中，或通过 VPN 连接。
4. 确保你的网络允许发往 XBOX 开发工具包 9002 端口的 TCP 和 UDP 流量。浏览器使用 WebSocket 连接进行信令传输，并使用 UDP 传输串流。

要通过 IP 地址连接：

1. 转到 [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools)。输入沙盒 ID，然后使用该沙盒的测试帐户登录。
2. 转到 [xbox.com/play/dev-tools/ip-connect](https://www.xbox.com/play/dev-tools/ip-connect)。
3. 输入 XBOX 开发工具包的 IP 地址和端口，例如 `192.168.1.10:9002`。
4. 选择 **Connect**。
5. 如果浏览器请求访问本地网络上设备的权限，请选择 **Allow**。

连接成功后，XBOX 开发工具包上运行的应用会显示在浏览器中。如果你使用零售帐户登录，IP Connect 地址会将你带回开发者工具页面。

## Remote Connect

Remote Connect 通过 XBOX 远程游玩服务经由 Internet 从你的 XBOX 开发工具包进行串流。它通过你登录的帐户查找开发工具包，因此无需输入 IP 地址。

首先，设置 XBOX 开发工具包：

1. 使用你将在 xbox.com/play 上使用的帐户登录 XBOX 开发工具包。该帐户必须在开发工具包的沙盒中获得允许。
2. 转到 **Dev Home** > **Streaming**。在 **Remote Connect** 下，选择你的帐户。
3. 在 **Dev Home** > **Streaming** 中，确保 **Direct Connect** 未在侦听。Direct Connect 是用于 IP Connect 的独立连接模式，在侦听时会阻止 Remote Connect。

然后从 xbox.com/play 进行连接：

1. 转到 [xbox.com/play/dev-tools](https://www.xbox.com/play/dev-tools)，并使用同一帐户登录。对于沙盒测试帐户，请在登录前输入沙盒 ID。
2. 选择 **Remote Connect**。当你登录的帐户拥有已为 Remote Connect 设置的开发工具包，或者你使用沙盒测试帐户登录时，此选项可用。
3. 在列表中找到你的 XBOX 开发工具包，然后选择 **Connect**。

> [!NOTE]
>
> XBOX 开发工具包和你用于连接的设备都需要连接到 Internet。
>
> 与 IP Connect 不同，Remote Connect 不要求两台设备位于同一网络中。

## 开发者设置

要打开开发者设置，请选择你的个人资料图片，然后选择 **Settings** > **Developer**。

开发者设置包括当前产品和串流配置设置。有关可覆盖的具体串流配置设置的详细信息，请参阅[串流配置概述](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-content-test-application-stream-config.md)。

在 **Stream Configuration** > **Touch adaptation** 下，你可以设置：

* **Enable sideload**：从 [TAK CLI](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line.md) `serve` 命令加载触控布局，而不是使用为你的游戏发布的布局。
* **Sideload server address**：旁加载服务器的地址。
* **Enable automatic refresh**：当你在旁加载服务器上更改布局时，更新设备上的布局。
* **Emulate touch with mouse**：将鼠标点击视为触控。

## TAK 旁加载

这些步骤介绍如何从自定义产品或 XBOX 开发工具包进行串流。若要使用产品，请参阅[选择产品](#select-an-offering)。

开始之前，请在提供布局的 PC 上运行 [`tak serve`](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command)。

要从与浏览器相同的 PC 进行旁加载：

1. 打开 **Settings** > **Developer**，找到 **Touch adaptation**。
2. 开启 **Enable sideload**。
3. 在 **Sideload server address** 中，输入旁加载服务器的地址，例如 `http://localhost:9269`。如[从其他设备旁加载](#sideload-from-another-device)中所述，`localhost` 以外的任何地址都必须使用 `https`。
4. 在 **Network Status** 下，检查 **Network Permission**。如果显示 **Required**，请选择 **Request Permission**。当浏览器询问是否允许该站点 **Access other apps and services on this device** 时，选择 **Allow**。
5. 在没有触摸屏的 PC 上，开启 **Emulate touch with mouse**。如果不开启，串流中将不显示触控控件，并且 **TAK** 菜单不可用。
6. 当 **Server Connection** 显示 **Connected** 时，开始串流。如果显示 **Not Reachable**，请确保 `tak serve` 正在运行，然后选择 **Recheck**。

在串流期间更改 **Enable sideload** 或 **Emulate touch with mouse** 时，系统会提示你切换游戏。

若要确认串流使用的是你的布局，请按照[在串流期间切换 TAK 布局](#switch-tak-layouts-during-a-stream)中的说明，在 **Bundle layouts** 下查看它们。

### 从其他设备旁加载

若要在手机或平板电脑上进行测试，请在设备可通过本地网络访问的 PC 上运行 `tak serve`。服务器必须使用 `https`：

1. 创建证书。有关详细信息，请参阅[证书生成说明](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md#certificate-generation-instructions)。
2. 在 PC 上，使用 `--certificate-file` 和 `--certificate-password` 选项运行 `tak serve`。
3. 在手机或平板电脑上安装并信任该证书。有关步骤，请参阅[在不同客户端上信任证书](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md#trusting-the-certificate-on-different-clients)。
4. 在手机或平板电脑上，打开 **Settings** > **Developer**，开启 **Enable sideload**，并在 **Sideload server address** 中输入 `https://<your PC's IP address>:9269`。
5. 按照 [TAK 旁加载](#tak-sideload)中步骤 4 和步骤 6 的说明，检查 **Network Permission** 和 **Server Connection**。

若要要求输入密码，请使用 `--password` 选项，并在设备的开发者设置中输入相同的密码。有关详细信息，请参阅 [Serve 命令](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-serve-command.md)。

## 在串流期间切换 TAK 布局

在开发者模式下，你可以在串流时切换活动布局：

1. 在串流中，打开左下角的 **Developer Tools Menu**，然后选择 **TAK**。
2. 在 **Select touch controls layout** 下，从 **Bundle layouts** 或 **System layouts** 中选择一个布局。**Bundle layouts** 显示为此串流加载的布局。旁加载正常工作时，这些就是你的布局。
3. 选择 **Close**。

**System layouts** 包括 **Standard** 和 **Native Touch Only (Blank)**。**Standard** 显示标准控制器覆盖层。**Native Touch Only (Blank)** 会移除触控控件。

## 鼠标和键盘

开始之前，请按照[打开开发者工具](#open-developer-tools)中的说明打开开发者工具。

1. 在 **Settings** > **Developer** 中的 **Stream Configuration** > **Enabled input types** 下，开启 **Mouse and keyboard**。请在开始串流之前更改此设置。
2. 在 **Touch adaptation** 下，关闭 **Emulate touch with mouse**。两者都开启时，鼠标点击会被视为触控。
3. 开始串流。
4. 如果出现内容为 **Enter fullscreen mode to play with mouse and keyboard** 的横幅，请选择 **Enter fullscreen**。

要释放鼠标，请按 **Press *key* to release your mouse** 通知中显示的按键。

## 试用新体验

要切换到 play.xbox.com 上的新体验，请选择你的个人资料图片，然后选择 **Try the new experience** > **Try now**。要返回 xbox.com/play，请从你的个人资料中打开 **Account settings**，然后选择 **Exit preview**。


## Related topics

- [Web 内容测试应用 (CTA) 概述](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-web-content-test-application.md)
- [内容测试应用 (CTA) 串流配置](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-content-test-application-stream-config.md)
- [Windows 内容测试应用 (CTA) 概述（已弃用）](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-windows-pc-content-test-application.md)
- [Android 内容测试应用 (CTA) 概述（已弃用）](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/game-streaming-android-content-test-application.md)
- [使用 TAK CLI 部署触控布局](https://docs.xbox.com/zh-CN/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-deploying-touch-layout.md)