内容测试应用程序 (CTA) 流配置概述

本主题介绍内容测试应用程序中用于覆盖流配置设置的开发人员设置。

流式传输配置

可以通过单击用户的个人资料图像,然后选择选项的开发人员部分,从电脑和 Android 上的主页访问设置的流配置部分。 在 Web 上,可通过单击用户的个人资料图像旁边的齿轮图标来找到此部分设置。

流配置设置是在云流式传输服务上为你的游戏配置的设置集。 这些设置包括游戏的可用触控控件捆绑包等项目,以及游戏是否支持本机触控等信息。 在内容测试应用程序中,可以在本地覆盖这些设置,以便在专用产品/服务中进行流式传输或直接从 Xbox 开发工具包流式传输时,在这些不同模式下测试游戏的行为。 为了确保在使用云流式传输玩游戏时游戏的行为正确,请联系 Microsoft 帐户代表,确保云配置正确反映游戏的功能。

流配置的屏幕截图

已启用输入设置

设置 说明
本机触控 允许游戏直接接收触控事件并在游戏中以本机方式处理它们。
鼠标和键盘 允许游戏接收鼠标和键盘事件。

触摸适配

本部分中的设置都与如何将触控适配捆绑包用于游戏有关。 菜单中的子设置如下所示:

设置 说明
启用 TAK 旁加载 允许从旁加载服务器地址而不是从云配置加载触控捆绑包。
旁加载服务器地址 旁加载服务器的 Web 地址。 通常,这类似于远程计算机的 https://<your ip address>:9269 和连接到在本地计算机上运行的旁加载服务器时的 http://localhost:9269

⚠️ 注意:如果地址是 https 而不是 http,则触摸适配套件命令行工具 (tak.exe) 在执行 serve 命令时必须使用 --certificate-file 选项。 Web 内容测试应用程序 (CTA) 仅在连接到远程旁加载服务器时支持 https 旁加载地址。
启用自动刷新 允许在内容测试应用程序中自动更新触控捆绑包中的本地更改。
使用鼠标模拟触控 允许将鼠标单击视为触控事件。 如果在非触控设备上进行测试,这非常有用。

替代Stream配置

可以使用 URL 中的查询字符串替代上述流配置设置,以便进行测试。 设置及其相应的查询字符串如下所示:

设置 查询字符串
本机触控 devTools.enableNativeTouch
鼠标和键盘 devTools.enableMouseAndKeyboard
启用 TAK 旁加载 devTools.takSideloadEnabled
旁加载服务器地址 devTools.takServerAddress
启用自动刷新 devTools.takAutoRefresh
使用鼠标模拟触摸 devTools.takAllowMouseInteraction

例如,如果当前配置禁用了“鼠标和键盘”,并且你希望暂时启用它来测试游戏,则可以将查询字符串 devTools.enableMouseAndKeyboard=true 添加到游戏流式处理链接的 URL。 修改后的 URL 如下所示: https://www.xbox.com/en-US/play/launch/{title_name}/{title_id}?devTools.enableMouseAndKeyboard=true

加载具有这些替代的 URL 时,它会重定向到另一个页面,该页面会请求确认,以防止意外的错误配置替代。 如果所有替代设置都与当前设置相同,则会跳过该页。

替代流配置的屏幕截图

页面将显示所有设置,其替代值与当前设置不同。 如果替代值与当前设置值相同,则不会显示在列表中。 该页还将提供有关与其他设置值的潜在冲突的警告。 在此页上,可以选择放弃或应用更改。 单击“放弃更改”将放弃所有替代,并使用现有设置转到原始目标页面。 单击“应用更改”将提供两个选项来说明希望替代如何生效:

  • 仅适用于当前会话:这将保留 URL 中的替代,并将设置仅应用于当前浏览器页面会话。 然后,它将导航到原始目标页面。 离开当前页后,替代将消失。
  • 应用于将来的所有会话:这将使用替代值更新当前设置,并导航到原始目标页面,而不使用替代查询字符串,因为值保存在设置中。

确认替代设置后,每个页面会话仅显示一次替代设置页。 如果存在其他替代设置,页面将再次显示。