Google Home 测试套件

Google Home Test Suite 是一个 Web 应用,可让您自行测试智能家居 Action。Test Suite 会根据与您的帐号关联的设备和特征自动生成并运行测试用例。完成测试后,您可以查看测试结果,或填写提交表单以向 Google 提交测试结果。

Test Suite 执行的测试包括(但不限于)以下内容:

  • 检查是否已为您的设备和特征实现了报告状态请求同步

  • 验证是否为您的设备实现了 QUERY intent,以及其结果是否与报告状态结果匹配。

您可以点击下面的按钮,启动 Test Suite 工具:

启动 Test Suite

自行测试您的 Action

以下部分介绍了如何在设备和智能家居 Action 项目上运行 Test SuiteTest Suite 要求您登录后才能检查 Google Home Graph 中的设备并将命令直接发送到 Google Assistant

如需自行测试您的 Action,请按以下步骤操作:

  1. 在网络浏览器中,打开 Test Suite
  2. 使用右上角的按钮登录 Google。

  3. 配置 Project Details

    1. 项目 ID 字段中,输入智能家居 Action 的项目标识符。
    2. 点击下一步
  4. 配置测试设置

    1. 如果要认证智能家居 Action,请保留默认的报告状态/请求同步超时值不变。不过,对于测试,如果您的代理需要更多时间来向 Home Graph 报告状态,您可以更改超时值。
    2. 如果要认证智能家居 Action,请确保已启用 Test Request Sync 选项。在测试期间,系统会提示您添加、更新或移除设备,并检查 Home Graph 中的设备列表是否已更改。通过要测试的集成执行更改操作。受测集成必须始终为代理用户关联至少一个设备。

    3. 如果您使用的是 Scene 特征,请选择 Test Scene trait

    4. 如果您要为 Local Home 设备运行测试套件,请选择 Supports Local Home SDK

      1. 选择 Local FulfillmentSeamless Setup
      2. 如果设备可以在本地处理 QUERY intent,请点击 Supports Local Query
  5. 执行 Test Run 并查看结果:

    1. 点击 Next 开始运行测试。界面会显示被测设备和特征。
  6. 查看结果和提交页面:

    1. 测试完成后,点击下一步以查看结果。

测试结果包括通过和失败的测试数量,以及表示通过百分比的最终得分。

帐号关联验证测试

帐号关联在 Google 智能家居生态系统中发挥着重要作用。Test Suite 中的帐号关联验证测试可检查您的 OAuth 服务是否存在潜在问题。

帐号关联验证测试包含用于验证访问令牌刷新令牌的测试:

访问令牌验证测试

系统会测试从令牌交换端点返回的访问令牌,以确保其具有有效的格式并在返回时提供有效的刷新令牌。

测试商品 说明
检查访问令牌是否为 JWT 格式 Google 帐号关联不建议使用 JWT 格式的访问令牌。如果找到 JWT 格式,则会显示以下警告:The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
检查可过期的访问令牌是否具有刷新令牌。 当访问令牌可过期时,必须提供刷新令牌。 如果找不到刷新令牌,此测试将会失败。

刷新令牌验证测试

系统会测试刷新令牌,以确保令牌交换端点正确地用这些令牌交换新的访问令牌。

测试商品 说明
刷新令牌包含无效的刷新令牌,正在检查合作伙伴响应。 对于无效的刷新令牌请求,您的服务器应返回带有 {"error": "invalid_grant"} 的 HTTP 400 Bad Request 错误。如果响应与“错误代码或消息”不匹配,此测试用例将失败。如需了解详情,请参阅 用刷新令牌换取访问令牌
测试访问令牌在令牌刷新后是否已更新。 您应返回新的访问令牌以响应刷新令牌请求。如果您的服务器提供了相同的访问令牌,则测试用例将失败。
检查未过期的访问令牌是否仍然有效。 系统会显示访问令牌的过期时间。
检查刷新令牌在刷新期间是否已轮替。 我们会在发出刷新令牌请求后检查刷新令牌是否发生更改。如果刷新令牌发生更改,您的服务器应仅在使用了新的刷新令牌之后使旧刷新令牌失效,以防止可能破坏用户的帐号关联。如果您在使用新令牌之前使旧刷新令牌失效,测试将失败。

错误消息

下表列出了您可能遇到的一些常见错误消息,以及解决这些错误消息的建议方法。

错误消息 如何解决
HomeGraph API 之前未用于项目 <_id_> 或已停用 确保您已启用 HomeGraph API
找不到请求的实体 请检查您的 agentUserId 是否有效以及是否与您的服务相关联。

确保您对项目 ${your project id} 具有 resourcemanager.projects.get 权限,并已在同意屏幕中授予所有权限。

获取模块数据时出错:getModuleData error: Http Failure response for https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403

  1. 请按照排查 IAM 权限问题中的说明操作,确保您的帐号具有项目的 resourcemanager.projects.get 权限。
  2. 前往有权访问您帐号的应用页面,检查“智能家居测试套件”的以下权限:
    • 基本帐号信息
      1. 查看您 Google 账号的主电子邮件地址
      2. 查看您的个人信息,包括您已公开的任何个人信息
    • 其他访问权限
      1. 使用您的Assistant:对您的 Google 帐号的广泛访问权限
      2. 在 Home Graph 中检查和控制智能家居设备
    如果收到权限错误,请先移除访问权限,并在重新登录时授予同意屏幕中的所有权限。

提交测试结果

在提交认证表单之前,您的 Test Suite 结果必须通过 100% 的测试。如果您有任何需要手动测试的特征,您仍应运行 Test Suite 工具并附加结果,即使其未 100% 通过也是如此。

如需提交测试结果并认证你的智能家居 Action,请按以下步骤操作:

  1. 收到测试结果并准备好认证智能家居 Action 后,请在 Test Suite 工具中点击 Submit
  2. 点击下载测试结果按钮以检索您的测试结果。
  3. 请点击转到提交表单,将测试结果提交给 Google。
  4. 填写所有必填字段,然后点击提交