Android 上的委托用户体验

您可以使用 Commissioning API 在应用中启动调试流程,方法有两种:直接在应用中启动,或通过快速配对流程中的应用选择器启动。本部分将介绍每种类型的用户体验 (UX)。

由应用发起

在这种情况下,用户开始在您的应用程序中进行委托,通常是通过“添加设备”之类的行动号召 (CTA)。我们建议您按如下方式突出显示添加设备按钮:

  • 用户可查看所有设备的位置,例如控制页面
  • 用户可以在此处管理主页,例如 设置 页面
  • 应用的首页

调试完成后,建议将用户引导至应用的首页,或应用中可向用户显示刚刚设置的设备控制器或显示所有设备(包括刚刚设置的设备)的完整列表的位置。

图 2 展示了相应用户体验:

  • 应用程序发起的调试(步骤 1)

    应用用户点击 添加设备

  • 应用发起的调试(第 2 步)

    用户扫描二维码或输入配对码。

  • 应用发起的调试(第 3 步)

    系统会提示用户同意将设备添加到 Google 平台(这对应于图 1 中的“同意 + 元数据”),并选择要使用的 Google 账号。

  • 应用发起的调试(第 4 步)

    如果用户拥有多个住宅,系统会提示他们选择一个住宅。如果用户未设置住宅,系统会自动创建一个名为“住宅”的住宅。

  • 应用发起的调试(第 5 步)

    调试 API 连接到设备。

  • 应用发起的调试(第 6 步)

    系统会提示用户选择设备所在的会议室。

  • 应用程序发起的调试(步骤 8)

    系统会提示用户重命名设备。

  • 应用发起的调试(第 10 步)

    调试 API 生成 Matter 凭证,检查网络连接,然后执行调试过程,将设备连接到选定的网络结构。

  • 应用程序发起的调试(步骤 11)

    如果已授予用户住宅和设备的权限,设备应会与该住宅中的其他设备一起显示在 Home 中,并且可以使用该应用进行控制。

    如果尚未授予用户对结构和设备的权限,则该设备尚不应在应用中显示或可供控制。 需要权限 才能在应用程序中访问和控制设备。

图 2:应用程序发起的调试

由快速配对发起

在 Android 系统中,也可以使用快速配对功能启动调试。扫描设备的 Matter 二维码后,系统会提示用户选择一个应用来继续调试流程。选择您的应用程序会利用应用程序中的调试 API,如图 3 所示。

如果用户未在其移动设备上安装该应用,系统会提示用户先安装该应用,然后再继续。从同意屏幕开始的用户体验与图 2 中的相同。

  • 快速配对调试(第 1 步)

    用户将被提示扫描二维码。

  • 快速配对调试(步骤 2)

    用户扫描设备的 Matter 二维码。

  • 快速配对调试(第 3 步)

    系统会提示用户选择一个应用,以继续完成调试流程。

  • 快速配对调试(第 4 步)

    如果该应用尚未安装,系统会提示用户进行安装。

  • 快速配对调试(步骤 5)

    应用是从 Google Play 商店下载的。

  • 快速配对调试(步骤 6)

    应用已安装。

  • 快速配对调试(第 7 步)

    成功安装应用后,系统会提示用户继续操作。

  • 快速配对调试(步骤 8)

    系统会提示用户同意将设备添加到 Google 平台(这对应于图 1 中的“同意 + 元数据”),并选择要使用的 Google 账号。

  • 快速配对调试(第 9 步)

    如果用户有多个住宅,系统会提示用户选择一个住宅。如果用户未设置住宅,系统会自动创建一个名为“住宅”的住宅。

  • 快速配对调试(第 10 步)

    调试 API 连接到设备。

  • 快速配对调试(第 11 步)

    用户需要选择设备所在的房间。

  • 快速配对调试(第 13 步)

    系统提示用户重命名设备。

  • 快速配对调试(第 15 步)

    Commissioning API 会生成 Matter 凭据、检查网络连接,然后执行调试流程,将设备连接到所选的网状网络。

  • 快速配对调试(步骤 16)

    如果已授予用户住宅和设备的权限,设备应会与该住宅中的其他设备一起显示在 Home 中,并且可以使用该应用进行控制。

    如果尚未授予用户对结构和设备的权限,则该设备尚不应在应用中显示或可控。 需要权限才能在应用中访问和控制设备。

图 3:快速配对调试

应用选择器

应用选择器视图,显示两个可供选择的应用。

在部署过程中,您的应用在应用选择器中有两种显示方式:

  1. 选择一个应用屏幕。
  2. 如果用户选择 选择其他应用,它将显示在 其他已安装应用 屏幕上。

建议的应用

应用选择器显示两个建议的应用。

  • 第一个始终为 Google Home app (GHA)
  • 第二种是设备制造商的首选应用,如果该应用是在与设备的 VID 或 PID 关联的 Google Home Developer Console 项目中定义的,则属于这种情况。(此选项不适用于不构建Matter设备的应用程序开发者。) 设备制造商首选委托人应用程序

当应用位于选择应用界面上时,有两种情况。

  1. 已安装 - Google Play services 检查应用程序是否支持 ACTION_COMMISSION_DEVICE intent 过滤器。如果缺少意图过滤器,则会将用户引导至 Play 商店更新应用程序。
  2. 未安装 - 用户将被引导至 Play 商店安装应用后再继续。