Panduan
Cara menggunakan Health di Capacitor
Menggunakan @capgo/capacitor-health
Plugin Capacitor untuk berinteraksi dengan data dari Apple HealthKit dan Health Connect.
Instal
bun add @capgo/capacitor-health
bunx cap sync
bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.
Impor
import { Health } from '@capgo/capacitor-health';
Sekilas tentang API
| Metode | Deskripsi |
|---|---|
isAvailable |
Mengembalikan apakah platform saat ini mendukung native health SDK. |
requestAuthorization |
Meminta akses baca/tulis ke tipe data yang disediakan. |
checkAuthorization |
Memeriksa status otorisasi untuk tipe data yang ditentukan tanpa memunculkan prompt ke user. |
readSamples |
Membaca sampel untuk tipe data tertentu dalam rentang waktu yang ditentukan. |
saveSample |
Menulis satu sampel ke native health store. |
openHealthConnectSettings |
Membuka layar pengaturan Health Connect (khusus Android). Pada iOS, metode ini tidak melakukan apa pun. |
showPrivacyPolicy |
Menampilkan kebijakan privasi aplikasi untuk Health Connect (khusus Android). Pada iOS, metode ini tidak melakukan apa pun. |
queryWorkouts |
Mengambil data sesi latihan dari native health store. Mendukung iOS (HealthKit) dan Android (Health Connect). |
queryAggregated |
Mengambil data kesehatan teragregasi dari native health store. Data diagregasi ke dalam bucket waktu (jam, hari, minggu, bulan) dengan operasi seperti sum, average, min, atau max. Ini lebih efisien daripada mengambil sampel satu per satu untuk rentang tanggal yang besar. |
Contoh
isAvailable()
Mengembalikan apakah platform saat ini mendukung native health SDK.
import { Health } from '@capgo/capacitor-health';
const result = await Health.isAvailable();
console.log(result);
requestAuthorization()
Meminta akses baca/tulis ke tipe data yang disediakan.
import { Health } from '@capgo/capacitor-health';
const result = await Health.requestAuthorization({ read: ['steps'] });
console.log(result);
checkAuthorization()
Memeriksa status otorisasi untuk tipe data yang diberikan tanpa memunculkan prompt ke user.
import { Health } from '@capgo/capacitor-health';
const result = await Health.checkAuthorization({ read: ['steps'] });
console.log(result);
readSamples()
Membaca sampel untuk tipe data tertentu dalam rentang waktu yang ditentukan.
import { Health } from '@capgo/capacitor-health';
const result = await Health.readSamples({ dataType: 'steps' });
console.log(result);
saveSample()
Menulis satu sampel ke native health store.
import { Health } from '@capgo/capacitor-health';
await Health.saveSample({
dataType: 'steps',
value: 1,
});
openHealthConnectSettings()
Membuka layar pengaturan Health Connect (khusus Android). Pada iOS, metode ini tidak melakukan apa pun.
import { Health } from '@capgo/capacitor-health';
await Health.openHealthConnectSettings();
Tabel di atas mencantumkan 9 metode inti. Helper listener, versi, dan kontrak lengkap setiap metode didokumentasikan di repositori GitHub.
Referensi lengkap
Lanjutkan dari Menggunakan @capgo/capacitor-health
Jika Anda menggunakan Menggunakan @capgo/capacitor-health untuk merencanakan pekerjaan plugin native, hubungkan dengan @capgo/capacitor-health untuk detail implementasi di @capgo/capacitor-health, Panduan Memulai untuk detail implementasi di Getting Started, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi di Plugin Capacitor oleh Capgo, dan Menambahkan atau Memperbarui Plugin untuk detail implementasi di bagian Menambahkan atau Memperbarui Plugin.