Halaman ini menjelaskan fungsi utama Health Connect API.
Operasi CRUD pada sinkronisasi data dan catatan
Platform ini menyediakan fungsi penyisipan, pembaruan, dan penghapusan standar untuk data yang direkam. Health Connect juga menyertakan fungsi yang memungkinkan aplikasi klien menyinkronkan data dari Health Connect. Sinkronisasi ini kemudian menghasilkan log perubahan data yang menunjukkan kepada developer dan pengguna apakah jenis data tertentu telah dimasukkan atau dihapus oleh aplikasi lain.
Fungsi agregasi dasar
Klien dapat menerapkan fungsi agregasi pada data pokok, yang memberikan berikut ini:
- Nilai rata-rata, minimum, atau maksimum (misalnya, detak jantung minimum dan maksimum selama sesi aktivitas).
- Total jumlah (misalnya, total jumlah langkah dalam interval harian).
- Jumlah sederhana dari jumlah pengukuran pokok (misalnya, jumlah sesi aktivitas dalam minggu tertentu).
- Total durasi pada jenis data yang didukung (misalnya, waktu yang dihabiskan dalam tidur nyenyak minggu ini, atau total durasi sesi aktivitas hari ini).
Pemeriksaan ketersediaan
Health Connect kompatibel dengan Android SDK versi 28 (Pie) dan yang lebih tinggi. Dengan adanya SDK, aplikasi klien dapat menentukan apakah Health Connect API ada di perangkat berteknologi Android pengguna atau tidak. Jika tidak, Health Connect memicu pemeriksaan ketersediaan untuk menentukan apakah perangkat pengguna kompatibel atau tidak.
Pemeriksaan izin
Untuk membaca dan/atau menulis data kesehatan dan kebugaran pengguna per aplikasi, Health Connect mengharuskan Anda meminta izin mereka terlebih dahulu. Dengan begitu, Anda dapat melihat izin apa yang telah diberikan atau ditolak oleh pengguna.
Membaca dengan Health Connect
Pembacaan latar depan
Anda biasanya dapat membaca data dari Health Connect saat aplikasi Anda berada di latar depan. Dalam kasus ini, Anda dapat mempertimbangkan untuk menggunakan layanan latar depan untuk menjalankan operasi ini jika pengguna atau sistem menempatkan aplikasi Anda di latar belakang selama operasi baca.
Untuk situasi saat aplikasi Anda mungkin mengalami gangguan, seperti menampilkan pembacaan di aplikasi, baca langsung dari Health Connect ke aplikasi klien Anda.
Untuk situasi yang lebih Anda pilih agar aplikasi berjalan tanpa gangguan, gunakan layanan latar depan:
FOREGROUND_SERVICE_TYPE_HEALTH: Mengizinkan aplikasi tetap berada di latar depan untuk mengumpulkan data sensor, seperti aplikasi latihan fisik yang terus mengumpulkan data meskipun pengguna menempatkan aplikasi di latar belakang.FOREGROUND_SERVICE_TYPE_SHORT_SERVICE: Layanan jenis generik yang memungkinkan aplikasi terus mengumpulkan data penting untuk tugas yang memerlukan waktu kurang dari tiga menit, bahkan jika pengguna menempatkan aplikasi di latar belakang sebelum selesai.
Pembacaan latar belakang
Anda dapat meminta agar aplikasi Anda berjalan di latar belakang dan membaca data dari Health Connect. Jika Anda meminta izin Baca di Latar Belakang, pengguna dapat memberikan akses kepada aplikasi Anda untuk membaca data di latar belakang.