• 启动指令白名单和测试

启动指令白名单和测试

即使在屏幕关闭时，搭载 Android 5.x 及更高版本的设备也可以通过始终开启启动指令听取“Ok Google”。借助始终开启启动指令，用户可以轻松使用语音操控自己的设备来获取信息和执行操作，从而轻松畅享语音体验。

为了确保可以在不同类型的 Android 设备上使用启动指令，Google 与数字信号处理器 (DSP) 提供商合作，共同打造可供 OEM 使用的固件。这样一来，OEM 可以实现 Lollipop SoundTrigger HAL。Google 为 OEM 提供启动指令模型，并验证设备的准确性和延迟时间。

集成启动指令

根据设备的硬件功能，OEM 合作伙伴需要集成相关的 DSP 库和注册 APK。您需要具备以下几项：

  • DSP FW（启动指令检测 FW）- Google 通过 SOC 供应商提供此项。
  • 内核驱动程序和 HAL 实现示例（声音触发器）- Google 通过 SOC 供应商提供此项。
  • 注册 APK（启动指令模型）- Google 通过 GMS 版本提供此项。
  • Google 搜索应用 (AGSA) - Google 通过 Play 商店提供此项。

最新的注册 APK 位于启动指令 GMS 版本文件夹中，而集成说明位于始终开启“Ok Google”技术堆栈集成中。相关 DSP 库由 SOC 供应商发布。OEM 可以通过与其 TAM 联系或提交错误来验证他们是否拥有所需的库和 APK。

将 DSP 测试帐号列入白名单

要测试启动指令功能，合作伙伴需要一个已列入白名单的测试帐号。要创建测试帐号并将其列入白名单，请执行以下操作：

  1. 向启动指令组件提交错误，或者与您的 TAM 联系，请求他们提供一个测试帐号供您测试启动指令。如果您在开展上一个项目时已经获取了启动指令测试帐号，则可以使用同一测试帐号。
  2. 通过 Google 获取启动指令测试帐号。Google 根据以下命名惯例分配测试帐号：
    hotword.OEM_NAME.texting.###
  3. 使用分配的帐号名称创建 Gmail 帐号。您将管理此帐号，此帐号应该类似于：
    hotword.OEM_NAME.texting.###@gmail.com
  4. 创建 Gmail 帐号之后，请通知您的 TAM，以便他们可以将帐号信息添加到启动指令白名单。

验证启动指令功能

通过使用 Beta 版 Android Google 搜索应用 (AGSA) 进行测试来验证您设备上的启动指令功能。

  1. 使用您的测试帐号以 Beta 版测试人员身份注册，以便在您的计算机上登录 Google Play 测试计划。加入成为 Beta 版测试人员。
  2. 在设备上依次转到设置 > 用户和帐号，从设备上移除所有帐号。移除所有帐号后，添加以 Beta 版测试人员身份注册的测试帐号。
  3. 安装 Beta 版 AGSA。
  1. 在设备上打开 Google Play。
  2. 搜索“Google”，查看是否已安装 Beta 版。
  3. 如果未安装 Beta 版 AGSA，请选择成为 Beta 版测试人员，然后使用更新按钮来安装 Beta 版 AGSA。
  1. 初始化测试设备，以从服务器加载 Beta 版配置。
  1. 从设备中移除测试帐号。
  2. 清除 Google 搜索应用的所有数据和缓存。您可以依次转到设置 > 应用 > Google > 存储空间完成此操作。
  3. 在设置 > 用户和帐号下再次添加测试帐号。只应在设备上加载一个帐号。
  4. 重新启动设备。
  1. 训练语音模型。
  1. 通过长按主屏幕按钮启动 Google 助理。使用 Google 助理窗口右上角的罗盘图标来访问探索页面。在探索页面上，使用右上角的菜单栏访问设置。
  2. 在设置页面，依次转到 Google 助理 > Google 助理设备 > 手机。选择手机之后，您将转到该设备的 Google 助理设置页面。
  3. 在 Google 助理设置页面，启用通过 Voice Match 访问，然后选择语音模型。在语音模型页面，选择重新调校语音模型。
  4. 按照屏幕上的说明执行语音模型训练。

注意：如果其他测试人员已经使用同一测试帐号训练了语音模型，系统可能会显示一条云通知，要求您直接进入下一阶段，无需进行训练。在这种情况下，新的测试人员不应继续，而应该重新调校语音模型。

 

 

 

 

商业型号白名单

如果您的设备已经为商业发布或大批量生产测试做好准备，您可以根据设备的型号名称请求将其列入白名单。

  1. 在 Android 设备审批门户 (ADAP) 中注册型号信息。您必须先在 ADAP 中提交一个包含公司名称和型号名称的版本，然后才能提交将设备列入白名单的请求。公司名称和型号名称应该与请求中的名称相同。在发送白名单请求之前，您无需接受最终版本审批。
  2. 提交包含以下内容的 DSP 启动指令白名单表单：
  • 电子邮件地址 - 如果白名单请求中包含无效信息，您将会收到电子邮件通知。请提供请求提交人员的有效公司电子邮件地址。
  • 公司名称 - 公司名称必须与 ADAP 版本提交中的公司名称保持一致，否则系统将发送错误通知。
  • 宣传名称 - 分享设备的宣传名称。型号名称可能因目标市场或运营商而异，但它们应具有相同的宣传名称。通过提供宣传名称，您可以将该宣传名称下的多个型号名称作为一个组列入白名单。
  • 型号名称 - 在 DSP 启动指令白名单的浏览器用户代理字符串中提供型号名称。如果同一宣传名称下有多个型号名称，请使用英文逗号分隔各个型号名称，例如：“MODEL_A, MODEL_B, MODEL_C”。
  • 支持的启动指令 - 选择支持的启动指令。除非您有强有力的理由，否则我们强烈建议您同时支持“Ok Google”和“Hey Google”这两种启动指令。
  • DSP 芯片组 - 提供 DSP 芯片组信息，例如：Qualcomm WCD9340。
  • 压力测试结果（可选）- 执行启动指令压力测试，并为 dsp_trigger_and_screen_off 测试用例附加 3000 次迭代的结果（即结果文件夹中的 stress_test.log）。如需详细了解压力测试工具，请发送电子邮件至 hotword-partnerships-wl@google.com。提供压力测试结果有助于顺利完成将设备列入白名单这一过程，因为这些结果表明设备启动指令功能可以正常使用。
  • 支持 DSP 启动指令的操作系统版本的说明 - 某些设备可能会在未使用 DSP 启动指令功能的情况下启动，并通过操作系统升级维护版本 (MR) 启用 DSP 启动指令。说明 DSP 启动指令是受首次发布版本还是操作系统升级 MR 的支持。
  • 初始二进制文件的操作系统版本 - 分享首次发布 SW 的操作系统版本。
  • MR 二进制文件的操作系统版本 - 如果 DSP 启动指令受操作系统升级 MR SW 支持，请分享 MR SW 的操作系统版本。
  1. 如果白名单请求中存在任何问题，您将会收到通知电子邮件，其中包含具体的错误消息。
  2. 如果白名单请求有效，则系统会在 Buganizer 中的合作伙伴部分下方提交白名单错误，并会在列入白名单过程完成后使用 CL 信息进行更新。

调试提示

在测试“Hey Google”时将语言设置为英语。否则，请设置支持的语言区域设置。