读取原始数据

以下示例展示了如何在常见工作流中读取原始数据。

简易读取

Health Connect 中的“步数”数据类型会记录用户在两次读取数据之间完成的步数。步数是各健身和健康平台的常见测量内容。借助 Health Connect,您可以轻松读取和写入步数数据。

如需读取记录,请创建一个 ReadRecordsRequest 并在调用 readRecords 时提供它。

以下示例展示了如何读取特定时间段内用户的步数数据。如需查看 SensorManager 的扩展示例,请参阅步数数据指南。

suspend fun readStepsByTimeRange(
    healthConnectClient: HealthConnectClient,
    startTime: Instant,
    endTime: Instant
) {
    try {
        val response = healthConnectClient.readRecords(
            ReadRecordsRequest(
                StepsRecord::class,
                timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
            )
        )
        for (stepRecord in response.records) {
            // Process each step record
        }
    } catch (e: Exception) {
        // Run error handling here
    }
}

读取之前写入的数据

如果某个应用之前已向 Health Connect 写入了记录,那么该应用可以重新读取这些记录,而无需具备针对这些特定记录的读取权限。这适用于以下场景:在用户重新安装应用后,应用需要与 Health Connect 重新同步。

如需在此场景中读取数据,您需要在 ReadRecordsRequestdataOriginFilter 参数中,将软件包名称指示为 DataOrigin 对象。

以下示例展示了如何在读取步数记录时指示软件包名称:

try {
    val response =  healthConnectClient.readRecords(
        ReadRecordsRequest(
            recordType = StepsRecord::class,
            timeRangeFilter = TimeRangeFilter.between(startTime, endTime),
            dataOriginFilter = setOf(DataOrigin("com.my.package.name"))
        )
    )
    for (record in response.records) {
        // Process each record
    }
} catch (e: Exception) {
    // Run error handling here
}

30 天读取限制

Health Connect 可以读取首次授予任何权限前最多 30 天的数据。

不过,如果用户删除您的应用,权限历史记录将会丢失。如果用户重新安装您的应用并再次授予权限,则您的应用可以读取从该新日期最多回推 30 天的 Health Connect 数据。

示例

假设某用户在 2023 年 3 月 30 日首次向您的应用授予读取权限,则您的应用可读取的数据日期最早可回推到 2023 年 2 月 28 日

之后,该用户在 2023 年 5 月 10 日删除了您的应用。用户决定在 2023 年 5 月 15 日重新安装该应用,并授予读取权限。现在,您的应用可读取的数据最早可追溯至 2023 年 4 月 15 日

前台限制

只有在前台运行的应用才能通过 Health Connect 读取数据。此限制旨在进一步加强用户隐私保护,让用户能够确信 Health Connect 对其数据没有后台读取访问权限,只能在前台读取和访问数据。

对于允许出现中断的情况(例如在应用中显示读数),请直接从 Health Connect 读取客户端应用。

对于不希望出现中断的情况(例如从 Health Connect 读取一系列数据,然后将这些数据写入并上传到其他位置),请使用 ForegroundService,而不是可快速关闭的 activity。