应用的界面 (UI) 应着重阐明使用 Health Connect 的好处，并解释主要概念以方便用户深入了解集成的涵义。
您提供的用户体验 (UX) 应遵循三大指导原则：
- 一致：确保整个集成流程中的各个流程保持一致。
- 透明：预先说明 Health Connect 会如何与您的应用协作。
- 清晰：帮助用户通过您的应用访问健康数据共享。
从宏观层面来看，用户体验流程可分为以下阶段：
推介 Health Connect
在应用中展示健康数据共享取决于界面中制定的用户体验模式和惯例。
强调用户将如何获益
首次向用户介绍健康数据共享时，您应该提供有说服力的理由，吸引用户使用您的集成功能。
您应该说明用户能从这些功能中获得哪些益处，而不是描述 Health Connect 的功能。
使用清晰的语言
不要求用户“连接到 Health Connect”。这是一个令人反感的句子，也可能会让用户对健康数据共享生态系统中应用之间的关系产生混淆。
您的用户体验应该有助于用户了解 Health Connect 如何与您的应用进行互动，因此务必考虑哪些按钮标签在实现这一目标方面效果最佳。
尝试对按钮标签使用动词短语，如“设置”或“开始”。或者，如果您要启动权限视图，可以使用更具体的按钮文字，例如“选择要分享的数据”。
推介 Health Connect
以下是一些在应用中推广健康数据共享的方法：
- 作为应用设置流程的一部分
- 通过应用主屏幕中的卡片
- 通过设置界面中的入口点
- 针对 Android 13 及更低版本的 Android 13 APK 下载按钮
- 宣传新数据类型时
- 更新应用时显示模态或对话框，类似于应用的设置流程
应用设置和权限请求流程
主屏幕推广卡片流程
设置
Android 13 APK 下载
启用新数据类型并请求权限
已集成健康数据共享的应用可以请求除已获授予的权限之外的新数据类型。
权限界面中应仅显示所请求的新数据类型，以免让用户感到困惑。
以下是一些有关如何宣传新数据类型的示例：
重复使用现有规范
如果您的应用已在其他生态系统中宣传新数据，我们建议您在 Android 中针对“健康数据共享”执行相同的操作，并根据需要调整语言。
强调价值主张
用户为何要在您的应用中使用这些数据？
- 示例：解读数据
- 让用户在您的应用中获得更准确的分析洞见
- 用户可以在您的应用中一站式查看所有数据
- 示例：写入数据
- 用户可以将您应用中的这些新数据与其他兼容的健康和健身应用共享
情境化权限
在用户能够理解的情况下请求新权限，以便他们了解您要求他们做什么。
示例：
- 在用户完成应用中的锻炼后，请求锻炼路线权限。
- 如果您的应用实现了新的权限，请在主屏幕上通过一个宣传广告一起展示这些权限。
- 如果您的应用中有专门的部分（例如睡眠），请在该部分中宣传相应权限。
已撤消和取消的权限
应用的“设置”界面应向用户显示如何撤消对健康数据共享数据类型的权限：
权限不足
如果您的应用没有足够的 Health Connect 访问权限，系统会在所有入口点向用户显示以下界面：
权限被取消两次
如果用户在权限请求界面上连续两次选择取消，您的应用应向用户显示类似于以下内容的界面：
读取和显示数据
为赢得用户信任并让用户安心，请务必向用户展示应用会如何获取数据，这些数据来自 DataOrigin 类的 packageName 属性。
您可以采用下列两种方法：
基本归因
最起码，您的界面 (UI) 应显示应用来源图标和名称（或者仅应显示应用名称，如果图标无法显示的话）。 基本归因适用于以下界面：首页、活动日志和活动详情。
为了支持适当的提供方信息，您的应用可以显示最初记录数据的应用的名称和图标。这有助于提高用户信任度，并清楚说明健康信息的来源。
您无需请求任何敏感权限（例如 QUERY_ALL_PACKAGES）即可检索此信息。以下示例演示了如何从 PackageManager 中检索给定软件包的应用标签和图标：
fun getAppLabelAndIcon(context: Context, packageName: String): Pair<CharSequence?, Drawable?>{
return try {
val pm = context.pacageManager
val appInfo = pm.getApplicationInfo(packageName, 0)
val label = pm.getApplicationLabel(appInfo)
val icon = pm.getApplicationIcon(appInfo)
label to icon
} catch (e: PackageManager.NameNotFoundException){
null to null
}
}
此实用程序通过在数据旁边显示应用名称和图标来确保适当的提供方信息。请参阅 HealthConnectManager.kt 示例中的实现。
教育性归因
您的应用应提供指向 Health Connect 中“应用权限”界面的直接链接，以便用户轻松获取有关数据来源的信息。此类归因适用于以下界面：活动详情、报告和数据分析。
数据同步
如果应用在与健康数据共享同步时延迟时间较长，我们建议应用在同步数据时显示此通知。这会告知用户正在发生某些事情，并且可能需要一段时间才能完成。如果您使用通知进行同步，则应默认将其设置为低优先级。
素材资源
商品图标应使用白色或浅灰色背景。 如有必要，您也可以在黑色背景上使用该图标。
下载以下图标：
