刪除資料

將資料刪除是 Health Connect CRUD 作業中重要的一環。本指南說明刪除記錄的兩種方式。

使用記錄 ID 進行刪除

您可以使用專屬 ID 清單刪除記錄，例如記錄 ID 和應用程式用戶端記錄 ID。請使用 deleteRecords，並提供兩份 Strings 清單，一份為記錄 ID 清單，另一份為用戶端 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
    }
}