适用于 Commissioning API 的多管理员

授权 API 支持 Matter 的多管理(或多管理员)模式,这意味着授权 API 可以充当主要或次要 Matter 授权者,并且您可以添加自己的授权者:

  • 作为主要 Matter 委托人:

    • 在此模式下,系统会先使用 Google 用户体验添加 Google Fabric。
    • 您可以添加自定义委托人。
      • 在将 Google Fabric 添加到设备后,系统会调用您的委托人,然后重新打开 Matter 委托窗口。
      • 如果 Google 因任何原因无法先完成对其自有 Fabric 的调试,您的自定义调试服务将无法运行。
  • 作为辅助 Matter 调试器:

    • 在此模式下,您可以实现自己的配置体验,并将其引入自己的 Fabric(或其他 Fabric)。
    • 稍后,您可以使用打开的配置窗口调用 Google 配置 API 以添加 Google Fabric。在此模式下,Google 强烈建议,当最终用户授予您使用 Home API 的权限后,应用应在配置流程完成后主动提示用户添加 Google 的 Fabric(使用 Commissioning API)。

如何使用 Commissioning API 作为主要 Matter 委托人

以下步骤展示了 Google 首选的 Matter 全功能配置流程:

  1. 用户在应用中启动配置流程。例如,用户点按标记为添加设备的按钮。

  2. Google 用户体验接管并显示扫描 Matter 二维码屏幕,以便用户扫描二维码以开始设置流程。

  3. 将此设备与您的 Google 账号相关联屏幕上,用户点按我同意以将设备添加到 Google 生态系统。如果用户在此屏幕上点按取消,则所有设备配置立即结束。

  4. 选择住宅界面上,用户选择用于控制设备的住宅。如果没有可用的住宅,系统会创建一个新住宅。 如果在住宅中找不到合适的集线器,或者用户缺少权限,则配置流程会结束。

  5. 接下来,系统应显示设备已连接屏幕,并开始 Matter 设置流程。用户可以在此屏幕上选择房间和设备名称。

  6. 当设备加入 Matter Fabric 时,系统会显示准备设备屏幕。

  7. 您的应用会恢复控制权,并且自定义委托方(如果已注册)会立即运行。

如何作为次要 Matter 委托人使用 Commissioning API

以下步骤展示了 Matter 配置流程,其中您的配置流程在 Google 配置流程之前进行:

  1. 用户在您的应用中启动配置流程。例如,用户点按添加设备

  2. 系统会运行您的配置体验流程,以将设备添加到您的 Fabric。

  3. 完成后,您可以根据对用户的了解,指定后续行为。例如,如果用户已选择启用 Google Home API,这可能表明用户希望向 Google 提交订单,您可以触发提交订单流程。

  4. 您的进程会调用 Commissioning API 并提供载荷,其中包含通行密码、标识符和其他可用信息。

  5. Google 调试流程会将设备添加到 Google 结构中。