授权 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 全功能配置流程:
用户在应用中启动配置流程。例如,用户点按标记为添加设备的按钮。
Google 用户体验接管并显示扫描 Matter 二维码屏幕,以便用户扫描二维码以开始设置流程。
在将此设备与您的 Google 账号相关联屏幕上,用户点按我同意以将设备添加到 Google 生态系统。如果用户在此屏幕上点按取消,则所有设备配置立即结束。
在选择住宅界面上,用户选择用于控制设备的住宅。如果没有可用的住宅,系统会创建一个新住宅。 如果在住宅中找不到合适的集线器,或者用户缺少权限,则配置流程会结束。
接下来,系统应显示设备已连接屏幕,并开始 Matter 设置流程。用户可以在此屏幕上选择房间和设备名称。
当设备加入 Matter Fabric 时,系统会显示准备设备屏幕。
您的应用会恢复控制权,并且自定义委托方(如果已注册)会立即运行。
如何作为次要 Matter 委托人使用 Commissioning API
以下步骤展示了 Matter 配置流程,其中您的配置流程在 Google 配置流程之前进行:
用户在您的应用中启动配置流程。例如,用户点按添加设备。
系统会运行您的配置体验流程,以将设备添加到您的 Fabric。
完成后,您可以根据对用户的了解,指定后续行为。例如,如果用户已选择启用 Google Home API,这可能表明用户希望向 Google 提交订单,您可以触发提交订单流程。
您的进程会调用 Commissioning API 并提供载荷,其中包含通行密码、标识符和其他可用信息。
Google 调试流程会将设备添加到 Google 结构中。