Langsung ke konten utama
@capgo/capacitor-health API Perangkat Open source

Kesehatan plugin Capacitor

Akses data kesehatan dan kebugaran dari platform kesehatan native

Instal

bun add @capgo/capacitor-health bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-health
  • pnpm add @capgo/capacitor-health
  • yarn add @capgo/capacitor-health

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.

FAQ

FAQ plugin Health

Bagaimana cara install plugin Health di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-health" (atau "npm install @capgo/capacitor-health"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mendeteksi code native. Import dari "@capgo/capacitor-health" di code aplikasi Anda.

Apakah @capgo/capacitor-health mendukung React, Vue, dan Angular?

Ya. Health adalah package Capacitor, jadi bisa digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-health?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-health gratis dan open source?

Ya. Source code bersifat publik di GitHub pada https://github.com/Cap-go/capacitor-health/ dan package ini gratis untuk diinstall dari npm. Bug reports dan pull requests sangat kami terima.

Bisakah saya memperbarui code yang menggunakan Health tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan Health tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo