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 diberikan tanpa meminta izin dari pengguna. |
readSamples |
Membaca sampel untuk tipe data tertentu dalam rentang waktu yang ditentukan. |
saveSample |
Menulis satu sampel ke penyimpanan kesehatan native. |
openHealthConnectSettings |
Membuka layar pengaturan Health Connect (hanya Android). Di iOS, metode ini tidak melakukan apa pun. |
showPrivacyPolicy |
Menampilkan kebijakan privasi aplikasi untuk Health Connect (hanya Android). Di iOS, metode ini tidak melakukan apa pun. |
queryWorkouts |
Mengambil sesi workout dari health store native. Didukung di iOS (HealthKit) dan Android (Health Connect). |
queryAggregated |
Mengambil data kesehatan agregat dari health store native. Data diagregasi ke bucket waktu (jam, hari, minggu, bulan) dengan operasi seperti sum, average, min, atau max. Ini lebih efisien daripada mengambil sampel individual untuk rentang tanggal 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 mem-prompt pengguna.
import { Health } from '@capgo/capacitor-health';
const result = await Health.checkAuthorization({ read: ['steps'] });
console.log(result);
readSamples()
Membaca sampel untuk tipe data yang diberikan 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 health store native.
import { Health } from '@capgo/capacitor-health';
await Health.saveSample({
dataType: 'steps',
value: 1,
});
openHealthConnectSettings()
Membuka layar pengaturan Health Connect (hanya Android). Di iOS, metode ini tidak melakukan apa pun.
import { Health } from '@capgo/capacitor-health';
await Health.openHealthConnectSettings();
Tabel di atas mencantumkan 9 metode inti. Listener dan helper versi, serta 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.