删除数据

删除数据是 Health Connect 中 CRUD 操作的关键环节。本指南将为您介绍如何通过以下两种方式删除记录。

提示： 如需有关删除数据的进一步指导，请参阅 有关读取和写入数据的 Android 开发者视频 。

使用记录 ID 进行删除

您可以使用唯一标识符（例如记录 ID 和应用的客户端记录 ID）列表来删除记录。具体方法是：使用 deleteRecords，并为其提供两个 Strings 列表，一个用于记录 ID，另一个用于客户端 ID。如果您只能提供其中一种 ID，可以在另一个列表中设置 emptyList()。

以下代码示例展示了如何使用相关 ID 删除步数数据：

suspend fun deleteStepsByUniqueIdentifier(
    healthConnectClient: HealthConnectClient,
    idList: List<String>
) {
    try {
        healthConnectClient.deleteRecords(
            StepsRecord::class,
            idList = idList,
            clientRecordIdsList = emptyList()
        )
    } catch (e: Exception) {
        // Run error handling here
    }
}

使用时间范围进行删除

您还可以将时间范围用作过滤条件来删除数据。具体方法是：使用 deleteRecords，并为其提供带有开始时间戳值和结束时间戳值的 TimeRangeFilter 对象。

以下代码示例展示了如何删除特定时间的步数数据：

suspend fun deleteStepsByTimeRange(
    healthConnectClient: HealthConnectClient,
    startTime: Instant,
    endTime: Instant
) {
    try {
        healthConnectClient.deleteRecords(
            StepsRecord::class,
            timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
        )
    } catch (e: Exception) {
        // Run error handling here
    }
}