Android 上的 Commissioning API 支持 Matter 的多管理(或多管理员),这意味着 Commissioning API 可以充当主要或次要 Matter 调试器,并且您可以添加自己的调试器:
作为主要 Matter 调试器:
- 在此模式下,首先使用 Google 用户体验添加 Google Fabric。
- 您可以添加自定义 Commissioner。
- 将 Google Fabric 添加到设备后,系统会调用您的配网工具,然后重新打开 Matter 配网窗口。
- 如果 Google 因任何原因无法先完成对自身 Fabric 的调试,您的自定义调试服务将不会运行。
作为辅助 Matter 调试器:
- 在此模式下,您可以实现自己的调试用户体验,并将其添加到自己的 Fabric(或其他 Fabric)中。
- 稍后,您可以在打开的调试窗口中调用 Google Commissioning API,以添加 Google Fabric。在此模式下,Google 强烈建议,当最终用户授予您使用 Home API 的权限时,应用在配置流程完成后主动提示用户添加 Google 的 Fabric(使用 Commissioning API)。
如何将 Commissioning API 用作主要 Matter 调试器
以下步骤展示了 Google 首选的 Matter 全功能调试流程:
用户在应用中启动调试流程。例如,用户点按标有添加设备的按钮。
Google 用户体验会接管并显示扫描Matter二维码界面,让用户能够扫描二维码以开始设置流程。
在将此设备与您的 Google 账号相关联界面上,用户点按我同意,将设备添加到 Google 生态系统。如果用户在此屏幕上点按取消,则所有设备调试都会立即结束。
在选择住宅界面上,用户选择可控制设备的住宅。如果没有可用的住宅,系统会创建一个新住宅。 如果在住宅中找不到合适的集线器,或者用户缺少权限,则调试过程会结束。
接下来应该会显示设备已连接屏幕,并且 Matter 设置流程会开始。用户可以在此界面上选择房间和设备名称。
当设备加入 Matter 结构时,系统会显示正在设置设备屏幕。
您的应用会重新获得控制权,并且自定义配网器(如果已注册)现在会运行。
如何将 Commissioning API 用作辅助 Matter 调试器
以下步骤展示了 Matter 调试流程,其中您的调试流程在 Google 调试流程之前进行:
用户在您的应用中启动调试流程。例如,用户点按添加设备。
系统会运行调试用户体验流程,将设备添加到您的 Fabric。
完成后,您可以根据对用户的了解来决定后续行为。例如,如果用户已选择启用 Google Home API,这可能表明用户希望委托给 Google,那么您可以触发委托流程。
您的流程会调用 Commissioning API 并提供载荷,其中包含密码、鉴别器和其他可用信息。
Google 调试流程会将设备添加到 Google 结构。