选择体验
Web CTA 可在两种 XBOX Cloud Gaming Web 体验上运行：xbox.com/play 和处于预览阶段的 play.xbox.com。请使用下表为你的场景选择一种体验：
两种体验均支持私有产品、沙盒测试帐户、区域选择以及鼠标和键盘。
打开开发者工具
要开始使用开发者工具，请访问 xbox.com/play/dev-tools。如果你尚未登录，该页面会要求你登录，并包含一个沙盒字段。- 对于零售帐户，请将沙盒留空，并使用已登录到 XBOX 开发工具包或已配置为可访问私有产品的同一帐户登录。
- 对于沙盒测试帐户，请在登录前输入沙盒 ID。
如果你在没有沙盒 ID 的情况下登录沙盒测试帐户，某些功能可能无法正常工作，因为这些帐户无权访问零售功能。
在 iOS 或 iPadOS 上，你可以将该页面保存为渐进式 Web 应用 (PWA)。选择共享按钮，然后选择 Add to Home Screen。PWA 会记住你的帐户和配置，以便你稍后返回继续测试。
选择产品
产品是用于验证在数据中心硬件上运行的游戏的私有测试环境。有关产品的详细信息，请参阅游戏串流概述。 要使用特定产品：- 转到 xbox.com/play/dev-tools/select-offering。
- 从下拉列表中选择产品，或选择 Custom offering ID 并在 Enter offering ID for cloud connection 中输入产品 ID。
- 选择 Connect。
产品区域
产品不会自动将你路由到最近的数据中心。若要在其他区域进行测试，请打开 Settings > Developer，并在 Streaming Region 下选择一个区域。请在开始串流之前进行选择。Current region 会显示你的选择。可用区域必须预先配置。请联系你的 Microsoft 客户代表，以调整你的产品可用的区域。IP Connect
使用 IP Connect 可通过 IP 地址直接从 XBOX 开发工具包进行串流。在 xbox.com/play 上，IP Connect 需要沙盒测试帐户，并且开发者工具页面不提供指向它的链接。 使用 IP Connect 之前，请完成以下先决条件：- 设置 XBOX 开发工具包以进行串流。有关详细信息，请参阅设置 XBOX 开发工具包。
- 在 Dev Home > Streaming 中，确保 Direct Connect 正在侦听。每次开发工具包重启后，它都会停止侦听。
- 确保你的客户端设备与 XBOX 开发工具包位于同一网络中，或通过 VPN 连接。
- 确保你的网络允许发往 XBOX 开发工具包 9002 端口的 TCP 和 UDP 流量。浏览器使用 WebSocket 连接进行信令传输，并使用 UDP 传输串流。
- 转到 xbox.com/play/dev-tools。输入沙盒 ID，然后使用该沙盒的测试帐户登录。
- 转到 xbox.com/play/dev-tools/ip-connect。
- 输入 XBOX 开发工具包的 IP 地址和端口，例如
192.168.1.10:9002。 - 选择 Connect。
- 如果浏览器请求访问本地网络上设备的权限，请选择 Allow。
Remote Connect
Remote Connect 通过 XBOX 远程游玩服务经由 Internet 从你的 XBOX 开发工具包进行串流。它通过你登录的帐户查找开发工具包，因此无需输入 IP 地址。 首先，设置 XBOX 开发工具包：- 使用你将在 xbox.com/play 上使用的帐户登录 XBOX 开发工具包。该帐户必须在开发工具包的沙盒中获得允许。
- 转到 Dev Home > Streaming。在 Remote Connect 下，选择你的帐户。
- 在 Dev Home > Streaming 中，确保 Direct Connect 未在侦听。Direct Connect 是用于 IP Connect 的独立连接模式，在侦听时会阻止 Remote Connect。
- 转到 xbox.com/play/dev-tools，并使用同一帐户登录。对于沙盒测试帐户，请在登录前输入沙盒 ID。
- 选择 Remote Connect。当你登录的帐户拥有已为 Remote Connect 设置的开发工具包，或者你使用沙盒测试帐户登录时，此选项可用。
- 在列表中找到你的 XBOX 开发工具包，然后选择 Connect。
XBOX 开发工具包和你用于连接的设备都需要连接到 Internet。与 IP Connect 不同，Remote Connect 不要求两台设备位于同一网络中。
开发者设置
要打开开发者设置，请选择你的个人资料图片，然后选择 Settings > Developer。 开发者设置包括当前产品和串流配置设置。有关可覆盖的具体串流配置设置的详细信息，请参阅串流配置概述。 在 Stream Configuration > Touch adaptation 下，你可以设置：- Enable sideload：从 TAK CLI
serve命令加载触控布局，而不是使用为你的游戏发布的布局。 - Sideload server address：旁加载服务器的地址。
- Enable automatic refresh：当你在旁加载服务器上更改布局时，更新设备上的布局。
- Emulate touch with mouse：将鼠标点击视为触控。
TAK 旁加载
这些步骤介绍如何从自定义产品或 XBOX 开发工具包进行串流。若要使用产品，请参阅选择产品。 开始之前，请在提供布局的 PC 上运行tak serve。
要从与浏览器相同的 PC 进行旁加载：
- 打开 Settings > Developer，找到 Touch adaptation。
- 开启 Enable sideload。
- 在 Sideload server address 中，输入旁加载服务器的地址，例如
http://localhost:9269。如从其他设备旁加载中所述，localhost以外的任何地址都必须使用https。 - 在 Network Status 下，检查 Network Permission。如果显示 Required，请选择 Request Permission。当浏览器询问是否允许该站点 Access other apps and services on this device 时，选择 Allow。
- 在没有触摸屏的 PC 上，开启 Emulate touch with mouse。如果不开启，串流中将不显示触控控件，并且 TAK 菜单不可用。
- 当 Server Connection 显示 Connected 时，开始串流。如果显示 Not Reachable，请确保
tak serve正在运行，然后选择 Recheck。
从其他设备旁加载
若要在手机或平板电脑上进行测试，请在设备可通过本地网络访问的 PC 上运行tak serve。服务器必须使用 https：
- 创建证书。有关详细信息，请参阅证书生成说明。
- 在 PC 上，使用
--certificate-file和--certificate-password选项运行tak serve。 - 在手机或平板电脑上安装并信任该证书。有关步骤，请参阅在不同客户端上信任证书。
- 在手机或平板电脑上，打开 Settings > Developer，开启 Enable sideload，并在 Sideload server address 中输入
https://<your PC's IP address>:9269。 - 按照 TAK 旁加载中步骤 4 和步骤 6 的说明，检查 Network Permission 和 Server Connection。
--password 选项，并在设备的开发者设置中输入相同的密码。有关详细信息，请参阅 Serve 命令。
在串流期间切换 TAK 布局
在开发者模式下，你可以在串流时切换活动布局：- 在串流中，打开左下角的 Developer Tools Menu，然后选择 TAK。
- 在 Select touch controls layout 下，从 Bundle layouts 或 System layouts 中选择一个布局。Bundle layouts 显示为此串流加载的布局。旁加载正常工作时，这些就是你的布局。
- 选择 Close。
鼠标和键盘
开始之前，请按照打开开发者工具中的说明打开开发者工具。- 在 Settings > Developer 中的 Stream Configuration > Enabled input types 下，开启 Mouse and keyboard。请在开始串流之前更改此设置。
- 在 Touch adaptation 下，关闭 Emulate touch with mouse。两者都开启时，鼠标点击会被视为触控。
- 开始串流。
- 如果出现内容为 Enter fullscreen mode to play with mouse and keyboard 的横幅，请选择 Enter fullscreen。