刪除資料

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

提示： 如需刪除資料的進一步指引，請參閱 用於讀取及寫入資料的 Android 開發人員影片 。

使用記錄 ID 進行刪除

您可以使用專屬 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
    }
}