本指南提供了用户体验方面的指导，旨在帮助您在应用中设计顺畅的 Google Home API 设备权限和共享功能，以提升用户首次使用体验。
本文介绍的主要主题包括：
为何要与 Google Home 共享设备？
如需使用 Home API 提供的功能，用户必须与 Google Home 共享设备，因为：
- 这是 Google 在自动化操作中使用这些设备的技术要求。
- 这有助于保持一致且灵活的 Google Home 体验。
- 确保设备在支持 Home API 的应用中以一致的方式呈现至关重要，这样可以避免创建零散且令人困惑的用户体验，让用户不必在应用之间切换来完成基本任务。
共享流程的关键组件
| 组件 | 计划 | 说明 |
|---|---|---|
| Android 上的 Permissions API | 适用于 Android 权限的 Home API | 提示用户向您的应用授予权限。在使用任何 Home API 之前，您的应用必须有权访问用户住宅中的设备（在 API 中称为结构）。不过，执行此步骤的顺序取决于开发者场景，并且包含在 技术实现中。 |
| 云到云关联 | 用于账号关联的云到云 | 让您可以在应用内启动账号关联流程，以便与 Google Home 共享云连接的设备 。为减少用户摩擦 ，我们建议使用深层链接功能 （Android 和 iOS 中均提供），该功能可将用户直接带到 GHA 中的特定账号关联页面 。 |
| Android 上的 Commissioning API | Matter 调试 | 虽然通常被认为是用于调试新 Matter 设备的 API，但您也可以使用此 API 将 Google 结构添加到已调试到另一个结构的 Matter 设备 。因此，这是 首次使用流程的实用工具。 |
技术实现
构建共享流程的方式取决于您计划与 Google 共享哪些设备。
对于以下场景，我们建议您按提供的顺序执行这些步骤。这有助于为用户提供更好的整体体验。
您只生产 Matter 设备
您生产支持 Matter 的设备，并希望将其调试到 Google Home。
调用 Android 上的 Permissions API。
在之前调试到另一个结构的每个 Matter 设备上调用 Android 上的 Commissioning API 。
- 由于必须单独为每个设备执行 Matter 共享，并且有许多屏幕需要用户输入，因此我们建议您通过以下方式引导用户完成此流程：
- 向用户提供未与 Google 共享的 Matter 设备列表。
- 允许用户通过点击该列表中的设备来启动设备共享流程（使用 Commissioning API）。
- 返回到 Matter 设备列表，向用户显示任务进度和共享状态。
- 由于必须单独为每个设备执行 Matter 共享，并且有许多屏幕需要用户输入，因此我们建议您通过以下方式引导用户完成此流程：
您只生产使用云到云 API 与 Google 共享的设备
执行Cloud-to-cloud深层链接。 这会将设备添加到 Google Home Graph。
- 我们建议先执行 Cloud-to-cloud 关联 以避免出现潜在的令人困惑的情况，例如向用户 呈现的列表中包含与 Google 共享的设备和未与 Google 共享的设备。
调用 Android 上的 Permissions API。
您同时生产云到云设备和 Matter 设备
-
- 我们建议先执行 Cloud-to-cloud 关联 以避免出现潜在的令人困惑的情况，例如向用户 呈现的列表中包含与 Google 共享的设备和未与 Google 共享的设备。
调用 Android 上的 Permissions API。
在之前调试到另一个结构的每个 Matter 设备上调用 Android 的 Commissioning API 。
- 由于必须单独为每个设备执行 Matter 共享，并且有许多屏幕需要用户输入，因此我们建议您通过以下方式引导用户完成此流程：
- 向用户提供未与 Google 共享的 Matter 设备列表。
- 允许用户通过点击该列表中的设备来启动设备共享流程（使用 Commissioning API）。
- 返回到 Matter 设备列表，向用户显示任务进度和共享状态。
- 由于必须单独为每个设备执行 Matter 共享，并且有许多屏幕需要用户输入，因此我们建议您通过以下方式引导用户完成此流程：
您没有任何设备可与 Google 共享
调用 Permissions API。
用户体验最佳实践
本部分包含一些关键用户历程，在开发利用 Home API 的应用时，请考虑这些历程。
在应用中引入设备共享的位置
这不是详尽的列表，您可能会找到其他机会，为用户提供及时的 Google Home 宣传和共享体验。
这些也不是互斥的，并且有多个入口点：
从“设置”菜单
由于用户可能习惯于通过“设置”菜单设置与 Google Home 生态系统的连接，因此此方法允许他们继续使用此范例。
您可能需要将设备共享（Cloud-to-cloud 关联和 Matter Commissioning API）与 应用权限（Permissions API）分开。这样，用户就可以控制完成哪些步骤，并且您有机会向用户显示连接状态。
在使用 Google 运行的自动化操作中的设备时
在“自动化操作”标签页中，用户可以点按共享流程的入口点，阅读价值主张屏幕，该屏幕清楚地说明了继续操作的好处，然后快速完成权限流程。
仅从调试
此场景主要适用于仅生产 Matter 设备 （无 Cloud-to-cloud 设备）且没有自己的 Matter 结构的合作伙伴。用户的入口点可以在开箱即用型屏幕之后立即出现，其中 Matter 设备共享（通过 Commissioning API）和应用权限（通过 Permissions API）是同一用户体验流程的一部分。
共享逻辑
以下是一些关于用户提示的建议：
您通常应提示用户仅完成首次使用平台所需的缺失步骤。例如，长期客户可能已与 Google 共享 OEM 的设备，在这种情况下，他们只需完成 Home API 权限授予流程，即可让应用访问其 Google Home。
多个 Google Home 管理员可能会共享 Google Home 结构，在某些情况下，可能仅使用一个账号与 Google 共享设备。 因此，完成 Cloud-to-cloud 关联不应成为 提示 Home API 权限的先决条件。
视觉设计建议
首次使用 Google Home 的明显好处（例如，“创建由 Google Home 提供支持的高级自动化操作”或“使用您选择的应用控制设备”）。
号召性用语（例如“开始使用”）以及在用户不想继续时取消的方式。
如果空间允许，请说明用户在完成屏幕操作后会发生什么情况。
对于 Matter，当用户之前 通过 Home API 授予您对其住宅的访问权限时，您可以在调试新设备时与 Google Home 共享其住宅中的设备。 例如，您可以将 Matter 设备添加到您的结构，然后提示用户将此设备 添加到 Google 结构。
内容建议
用户更容易信任他们了解且能增加价值的内容。 通过提供信息（包括权衡取舍）来帮助用户做出明智的决策。
关键宣传
如果没有强有力的价值主张，用户就不会继续共享设备。
- 请特别注意如何定位产品/服务。
- 使其具有吸引力，但不要过度承诺。
- 如果用户需要您宣传中提到的设备，请确保清楚说明，以免他们遇到意外障碍。
- 您可能只有一次机会吸引这些用户，因此请务必抓住机会。
最佳实践
- 从用户的角度出发，即“这对我有什么好处？”。
- 请勿在一个内容块中撰写超过四行的内容。字数过多可能会让用户失去注意力。不过，清晰、详尽可能比简洁更重要。
- 自动化操作很有趣！如果空间允许，请选择一个令人兴奋但有用的示例。
- 如果与您的整体策略一致，请尝试使用轻松愉快的语气。
- 使用可操作的短语，例如“开始使用”。