Langsung ke konten

@capgo/capacitor-health

Plugin Capacitor untuk berinteraksi dengan data dari Apple HealthKit dan Health Connect.

@capgo/capacitor-health membaca dan menulis data kesehatan pengguna melalui Apple HealthKit pada iOS dan Health Connect di Android. Gunakan untuk hitungan langkah, workout, fase tidur, tanda vital, dan sampel nutrisi tanpa perlu memelihara dua integrasi native SDK yang terpisah di lapisan aplikasi Anda.

Dashboard fitness, aplikasi habit, produk wellness terkait klinis, dan program wellness korporat biasanya dimulai dengan requestAuthorization, lalu readSamples atau saveSample untuk metrik yang mereka anggap penting.

PlatformDukunganCatatan
iOSYaOtorisasi HealthKit dan sampel
AndroidYaHealth Connect, izin riwayat opsional untuk bacaan lebih dari 30 hari
WebTerbatasisAvailable melaporkan native SDK yang tidak didukung

Helper khusus Android: openHealthConnectSettings, showPrivacyPolicy.

  • isAvailable - Mengembalikan apakah platform saat ini mendukung native health SDK.
  • requestAuthorization - Meminta akses baca/tulis untuk tipe data yang diberikan.
  • checkAuthorization - Mengecek status otorisasi untuk tipe data yang diberikan tanpa memunculkan prompt ke user.
  • readSamples - Membaca sampel untuk tipe data tertentu dalam rentang waktu yang ditentukan.
MetodeDeskripsi
isAvailableMengembalikan apakah platform saat ini mendukung native health SDK.
requestAuthorizationMeminta akses baca/tulis ke tipe data yang disediakan.
checkAuthorizationMemeriksa status otorisasi untuk tipe data yang diberikan tanpa meminta izin dari pengguna.
readSamplesMembaca sampel untuk tipe data tertentu dalam rentang waktu yang ditentukan.
saveSampleMenulis satu sampel ke penyimpanan kesehatan native.
getPluginVersionDapatkan versi plugin native Capacitor.
openHealthConnectSettingsMembuka layar pengaturan Health Connect (hanya Android). Di iOS, metode ini tidak melakukan apa pun.
showPrivacyPolicyMenampilkan kebijakan privasi aplikasi untuk Health Connect (hanya Android). Di iOS, metode ini tidak melakukan apa pun.
queryWorkoutsMengkueri sesi workout dari penyimpanan kesehatan native. Didukung di iOS (HealthKit) dan Android (Health Connect).
queryAggregatedMengkueri data kesehatan agregat dari penyimpanan kesehatan native. Mengagregasi data ke dalam bucket waktu (jam, hari, minggu, bulan) dengan operasi seperti sum, average, min, atau max. Ini lebih efisien daripada mengambil sampel individual untuk rentang tanggal yang besar.

Referensi ini disinkronkan dari src/definitions.ts di capacitor-health.

Jika Anda menggunakan @capgo/capacitor-health untuk merencanakan pekerjaan plugin native, hubungkan dengan Menggunakan @capgo/capacitor-health untuk kemampuan native di Menggunakan @capgo/capacitor-health, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.