Android 上的委托用户体验

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

由应用启动

在这种情况下,用户会在您的应用中启动调试,通常是通过“添加设备”号召性用语 (CTA) 启动。我们建议您按如下方式突出显示添加设备 按钮:

  • 在用户查看所有设备的位置,例如控制 页面
  • 在用户管理住宅的位置,例如设置 页面
  • 应用的首页

调试完成后,我们建议将用户引导至应用的首页,或应用中的某个位置,该位置会向用户显示他们刚刚设置的设备控制器,或显示所有设备的完整列表,包括刚刚设置的设备。

图 2 说明了用户体验:

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

    应用的用户点击 “添加设备”

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

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

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

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

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

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

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

    Commissioning API 会连接到设备。

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

    系统会提示用户选择设备所在的房间。

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

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

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

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

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

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

    如果尚未授予用户结构和 设备的权限,设备暂时不应在应用中显示或 可控。 如需在应用中访问和控制设备,必须获得权限

图 2:由应用启动的调试

由快速配对启动

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

如果用户未在其移动设备上安装该应用,系统会提示他们先安装该应用,然后再继续。从权限请求页面开始,用户体验与图 2 中的用户体验相同。

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

    系统会提示用户扫描二维码。

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

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

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

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

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

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

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

    应用从 Google Play 商店下载。

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

    应用已安装。

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

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

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

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

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

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

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

    Commissioning API 会连接到设备。

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

    系统会提示用户选择设备所在的房间。

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

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

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

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

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

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

    如果尚未授予用户结构和设备的权限,设备暂时不应在应用中显示或可控。 如需在应用中访问和控制设备,必须获得权限

图 3:快速配对调试

应用选择器

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

在调试过程中,您的应用会通过以下两种方式显示在应用选择器中:

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

建议的应用

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

  • 第一个始终是 Google Home app (GHA)
  • 第二个是设备制造商的首选应用,前提是该应用在与设备的 VID 或 PID 相关联的 Google Home Developer Console项目中定义。(此选项不适用于不 构建 Matter 设备的开发者。) 设备制造商首选的调试器应用

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

  1. 已安装 - Google Play services 检查应用是否支持 ACTION_COMMISSION_DEVICE intent 过滤器。如果 intent 过滤器缺失,系统会将用户定向到 Play 商店以更新应用。
  2. 未安装 - 系统会将用户定向到 Play 商店以安装应用 ,然后才能继续。