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

Android 上的 Commissioning API 支持 Matter 的多管理员(或 多管理员),这意味着 Commissioning API 可以作为主要或次要的 Matter 委托人,并且您可以添加自己的委托人:

  • 作为主要Matter专员:

    • 在这种模式下,首先添加 Google Fabric,使用 Google UX。
    • 您可以添加自定义委托人。
      • 在将 Google Fabric 添加到设备后,您的委托人将被通知,然后 Matter 委托窗口将重新开放。
      • 如果由于任何原因,Google 无法首先完成对其自身架构的调试,则您的自定义调试服务将无法运行。
  • 作为次要的Matter专员:

    • 在这种模式下,您可以实现自己的委托 UX,并将其引入到他们自己的面料(或其他面料)中。
    • 稍后可以通过打开的调试窗口调用 Google Commissioning API 来添加 Google Fabric。在这种模式下,Google 强烈建议,当最终用户授予您使用 Home API 的权限后,该应用应在您的调试流程完成后主动提示用户添加 Google 的 fabric(使用 Commissioning API)。

如何将委托 API 用作主要事项委托人

以下步骤展示了谷歌首选的Matter功能齐全的委托流程:

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

  2. Google UX 接管控制权并显示 扫描 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 系统中。