Panduan
Cara menggunakan Kesehatan di Capacitor
Menggunakan @capgo/capacitor-health
Plugin Capacitor untuk berinteraksi dengan data dari Apple HealthKit dan Health Connect.
Install
bun add @capgo/capacitor-health
bunx cap sync
bunx cap sync Menggandakan plugin code native ke proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.
Import
import { Health } from '@capgo/capacitor-health';
Ringkasan API
| Metode | Deskripsi |
|---|---|
isAvailable |
Mengembalikan apakah platform saat ini mendukung kesehatan native SDK. |
requestAuthorization |
Mengakses membaca/tulis data yang disediakan. |
checkAuthorization |
Mengatur status otorisasi untuk data yang disediakan tanpa meminta pengguna. |
readSamples |
Membaca sampel untuk data yang diberikan dalam rentang waktu tertentu. |
saveSample |
Mengirimkan sampel tunggal ke penyimpanan kesehatan native. |
openHealthConnectSettings |
Membuka layar pengaturan Health Connect (hanya Android). Pada iOS, metode ini tidak melakukan apa-apa. |
showPrivacyPolicy |
Mengampilkan kebijakan privasi aplikasi untuk Health Connect (hanya Android). Pada iOS, metode ini tidak melakukan apa-apa. |
queryWorkouts |
Mengambil sesi olahraga dari penyimpanan kesehatan native. Dukungan pada iOS (HealthKit) dan Android (Health Connect). |
queryAggregated |
Mengambil data kesehatan agregat dari penyimpanan kesehatan native. Menggabungkan data ke dalam wadah waktu (jam, hari, minggu, bulan) dengan operasi seperti jumlah, rata-rata, minimum, atau maksimum. Ini lebih efisien daripada mengambil sampel individu untuk rentang tanggal yang besar. |
Contoh
isAvailable()
Mengembalikan apakah platform saat ini mendukung kesehatan native SDK.
import { Health } from '@capgo/capacitor-health';
const result = await Health.isAvailable();
console.log(result);
requestAuthorization()
Meminta akses baca/tulis untuk jenis data yang disediakan.
import { Health } from '@capgo/capacitor-health';
const result = await Health.requestAuthorization({ read: ['steps'] });
console.log(result);
checkAuthorization()
Akses otorisasi status untuk jenis data yang disediakan tanpa meminta konfirmasi pengguna.
import { Health } from '@capgo/capacitor-health';
const result = await Health.checkAuthorization({ read: ['steps'] });
console.log(result);
readSamples()
Membaca contoh untuk jenis data tertentu dalam jangka waktu yang ditentukan.
import { Health } from '@capgo/capacitor-health';
const result = await Health.readSamples({ dataType: 'steps' });
console.log(result);
saveSample()
Mengirimkan contoh tunggal ke penyimpanan kesehatan native.
import { Health } from '@capgo/capacitor-health';
await Health.saveSample({
dataType: 'steps',
value: 1,
});
openHealthConnectSettings()
Membuka layar pengaturan Health Connect (hanya tersedia di Android). Di iOS, metode ini tidak melakukan apa-apa.
import { Health } from '@capgo/capacitor-health';
await Health.openHealthConnectSettings();
Daftar di atas menampilkan 9 metode inti. Pembantu pendengar dan versi, serta kontrak lengkap dari setiap metode, dapat dilihat di repositori GitHub.
Dokumentasi
Teruskan dari Penggunaan @capgo/capacitor-health
Jika Anda menggunakan Menggunakan @capgo/capacitor-health untuk merencanakan pekerjaan plugin native, hubungkannya dengan @capgo/capacitor-health untuk detail implementasi di @capgo/capacitor-health, Mulai Menggunakan untuk detail implementasi di Getting Started, Capgo Direktori Plugin untuk alur kerja produk di Capgo Direktori Plugin, Capacitor Plugin oleh Capgo untuk detail implementasi di Capacitor Plugin oleh Capgo, dan Menambahkan atau Mengupdate Plugin untuk detail implementasi di Menambahkan atau Mengupdate Plugin.