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