借助 Actions 控制台中的模拟器,您可以通过一个可模拟硬件设备及其设置的简单易用的网页界面来测试您的 Action。您还可以访问调试信息,例如执行方式接收和发送的请求和响应。
测试项目
测试您的 Actions 项目时,存在以下限制:
- 操作最长可测试 30 天。30 天后,您必须创建一个新版本以进行测试。
- 开发中的 Action 可以在任何受支持的硬件设备(Android 6.0+、iOS 9.1+ 和声控音响设备)上测试。设备必须登录您在 Actions 控制台中使用的 Google 帐号。说出“Ok Google, talk to my test app”会调用 Action 的当前草稿版本。
- 默认情况下,模拟器会使用处于草稿阶段的 Action 版本。了解如何选择要测试的其他版本。
输入法
您可以点击响应文本字段中的按钮,以指定用于测试的输入法。
以下列表介绍了输入源类型及其适用的设备:
- 自动检测 - 自动检测语音、键盘或触控输入。
- 触摸 - 用于提供互动体验和元素,例如建议内容信息卡。适用于智能显示屏和手机设备。
- Voice - 用于纯语音输入。适用于智能显示屏、手机和音响设备。
- 键盘 - 用于纯文字输入。适用于“电话”设备。
默认输入方法是自动检测。根据您选择的 surface,系统还会相应地停用和启用输入类型。
输入法以 inputType
字段的形式包含在对执行方式发出的每个请求中,具体位于 RawInput
对象中。
{
"inputType": "VOICE",
"query": "Tell me a fact about Google's headquarters"
}
指定设备
模拟器可以模拟不同的设备,并允许您测试 Action 的设备专属体验。
如需更改模拟设备,请按以下步骤操作:
点击左上角的设备下拉菜单。系统会默认选择智能显示屏。
请从以下设备中选择进行模拟:
- 智能显示屏 - 内置 Google 助理且具有显示屏和音箱功能的设备,如 Nest Hub。
- 手机 - 内置 Google 助理且具有显示屏和扬声器功能的手机。
- 音箱 - 内置 Google 助理且具有音箱功能的智能音箱。
- KaiOS - 内置 Google 助理且使用 KaiOS 的手机。
选择语言
您可以从第二个下拉菜单中选择一种语言,以设置要模拟的语言和地区。如需详细了解如何创建多语言 Action,请参阅本地化文档。
设置地点
您可以手动设置设备的坐标和地址。借助此功能,您可以测试您在控制台中设置的所有地理位置定位功能,以及您在执行方式中配置的针对特定区域的响应。
如需获取模拟位置以供您的 Action 使用,请使用用户信息帮助程序向用户请求访问权限。
设置
点击左上角的设置按钮,即可访问模拟器的其他选项。
选择一个版本
您可以指定要测试的 Actions 项目版本(已发布版本或草稿版本)。如需选择项目版本,请按以下步骤操作:
在模拟器中,点击右上角的 Settings 按钮。
点击选择版本旁边的下拉菜单,然后选择要测试的版本。
在版本下拉菜单中,选择要测试的 Actions 项目的版本,然后点击 DONE。您会看到已提交的所有版本,以及草稿版本。草稿版本表示项目在提交之前的当前状态。
测试网址
为避免在测试 Actions 项目时对生产环境进行更改,您可以提供一个独特的网址来代替生产 webhook。测试网址是按 Actions 项目的版本配置的。一个 Actions 项目可以有多个具有唯一测试网址的版本,让您可以在模拟器中测试多个 Action 版本,而不会影响正式版。
启用“测试网址”设置后,模拟器会替换您的 Actions 项目的生产网络钩子网址,改为使用您提供的测试网络钩子网址。
在模拟器中配置测试网址之前,请执行以下操作:
确定您要用于测试 Actions 项目的某个版本的网址。
配置要用于测试的服务器,以接受来自该网址的请求。
如需在模拟器中配置测试网址,请执行以下操作:
点击模拟器右上角的 Settings。
启用测试网址。
在测试网址框中,输入您要用于测试的网址。
您指定的测试网址会显示在模拟器中。
账号关联
通过帐号关联,您的 Action 可以使用 Google 登录、基于 OAuth 的 Google 登录“简化”关联或 OAuth。
如果您尚未为您的 Action 设置账号关联,请点击 Settings 下的 Set up account linking,前往控制台的 Account linking 部分。
要关联账号,请按以下步骤操作:
在 Actions 控制台模拟器中,在模拟器的输入区域中输入“talk to my test app”,以测试您的 Action。
发送一个查询,以初始化您的 Action 的帐号关联流程。
使用提示登录。
确认账号关联已成功。
在解除帐号关联之前,关联的帐号会一直存在,因此您可以在使用同一关联帐号的同时更新 Action。
要解除帐号关联,请依次点击帐号关联下的设置 > 解除关联。
设备端测试
通过此设置,您可以在实体设备上启用或停用测试。若要在设备上进行测试,您需要登录您创建 Actions on Google 项目时所用的帐号。
音频播放
在测试期间切换此选项,使其静音或启用音频播放。
开发沙盒
启用此选项后,付款方式不会产生费用。如需了解详情,请参阅事务文档。
模拟未经验证的用户
此选项可以模拟用户所使用的设备是否已为其他人设置 Voice Match。