适用于 Android 的 Commissioning API 的多管理员

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 全功能调试流程:

  1. 用户在应用中启动调试流程。例如,用户点按标有添加设备的按钮。

  2. Google 用户体验会接管并显示扫描Matter二维码界面,让用户能够扫描二维码以开始设置流程。

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

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

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

  6. 当设备加入 Matter 结构时,系统会显示正在设置设备屏幕。

  7. 您的应用会重新获得控制权,并且自定义配网器(如果已注册)现在会运行。

如何将 Commissioning API 用作辅助 Matter 调试器

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

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

  2. 系统会运行调试用户体验流程,将设备添加到您的 Fabric。

  3. 完成后,您可以根据对用户的了解来决定后续行为。例如,如果用户已选择启用 Google Home API,这可能表明用户希望委托给 Google,那么您可以触发委托流程。

  4. 您的流程会调用 Commissioning API 并提供载荷,其中包含密码、鉴别器和其他可用信息。

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