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