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

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

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

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

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

  4. 选择住宅界面上,用户选择可用于控制设备的住宅。如果没有可用的住宅,系统会创建一个新的住宅。 如果未在住宅中找到合适的中枢,或者用户缺少相应权限,则配置流程会结束。

  5. 接下来,系统应会显示设备已连接界面,然后开始执行 Matter 设置流程。用户可以在此界面上选择房间和设备名称。

  6. 当设备加入 Matter 平台时,系统会显示正在准备设备界面。

  7. 应用恢复控制权,如果已注册,则自定义调试器现在运行。

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

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

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

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

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

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

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