Contoh berikut menunjukkan cara membaca data mentah sebagai bagian dari alur kerja umum.
Tindakan membaca sederhana
Jenis data Langkah di Health Connect mendeteksi jumlah langkah pengguna di sela-sela pembacaan. Jumlah langkah mewakili pengukuran umum di seluruh platform kesehatan, kebugaran, dan kesegaran. Health Connect memudahkan Anda membaca dan menulis data jumlah langkah.
Untuk membaca data, buat ReadRecordsRequest dan berikan
saat Anda memanggil readRecords.
Contoh berikut menunjukkan cara membaca data jumlah langkah untuk pengguna dalam
waktu tertentu. Untuk contoh yang diperluas dengan SensorManager,
lihat panduan data
jumlah langkah.
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
}
}
Membaca data yang ditulis sebelumnya
Jika aplikasi telah menulis catatan ke Health Connect sebelumnya, aplikasi tersebut dapat membacanya kembali tanpa memerlukan izin Baca ke catatan tertentu. Hal ini berlaku untuk skenario saat aplikasi perlu disinkronkan ulang dengan Health Connect setelah pengguna menginstal ulang aplikasi.
Untuk membaca data dalam skenario ini, Anda perlu menunjukkan nama paket sebagai
objek DataOrigin dalam parameter dataOriginFilter dari
ReadRecordsRequest.
Contoh berikut menampilkan cara menunjukkan nama paket saat membaca data Langkah:
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
}
Batasan baca 30 hari
Health Connect dapat membaca data hingga 30 hari sebelum izin apa pun pertama kali diberikan.
Namun, jika pengguna menghapus aplikasi Anda, histori izin akan hilang. Jika pengguna menginstal ulang aplikasi Anda dan memberikan izin lagi, aplikasi Anda dapat membaca data dari Health Connect hingga 30 hari sebelum tanggal baru tersebut.
Contoh
Jika pengguna pertama kali memberikan izin baca ke aplikasi Anda pada 30 Maret 2023, data paling awal yang dapat dibaca kembali oleh aplikasi Anda akan berasal dari 28 Februari 2023 dan seterusnya.
Kemudian, pengguna tersebut menghapus aplikasi Anda pada 10 Mei 2023. Pengguna tersebut memutuskan untuk menginstal ulang pada 15 Mei 2023 dan memberikan izin baca. Tanggal awal data yang dapat dibaca aplikasi Anda sekarang adalah dari tanggal 15 April 2023.
Pembatasan latar depan
Pembacaan data dengan Health Connect dibatasi untuk aplikasi yang berjalan di latar depan. Pembatasan ini diberlakukan untuk lebih memperkuat privasi pengguna. Hal ini meyakinkan pengguna bahwa Health Connect tidak memiliki akses baca latar belakang ke data mereka, dan data hanya dibaca serta diakses di latar depan.
Untuk situasi saat gangguan dapat ditoleransi, seperti menampilkan pembacaan di aplikasi, baca langsung dari Health Connect ke aplikasi klien Anda.
Untuk situasi ketika Anda tidak menginginkan gangguan, misalnya membaca rentang
data dari Health Connect, lalu menulis dan menguploadnya di tempat lain, gunakan
ForegroundService, bukan Aktivitas yang dapat ditutup dengan cepat.