Guide
Comment utiliser la santé dans Capacitor
Tester sur appareil
Téléchargez l'application Capgo, puis scannez le code QR code.
Utilisation de @capgo/capacitor-santé
Le plugin Capacitor permet d'interagir avec les données de Apple HealthKit et Health Connect.
Installer
bun add @capgo/capacitor-health
bunx cap sync
bunx cap sync copie le plugin code natif dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.
Importer
import { Health } from '@capgo/capacitor-health';
API en un coup d'œil
| Méthode | Description |
|---|---|
isAvailable |
Indique si la plateforme actuelle prend en charge la santé native SDK. |
requestAuthorization |
Demande l'accès en lecture/écriture aux types de données fournis. |
checkAuthorization |
Vérifie l'état d'autorisation pour les types de données fournis sans solliciter l'utilisateur. |
readSamples |
Lit les échantillons pour le type de données spécifié dans la plage de temps spécifiée. |
saveSample |
Écrit un échantillon unique dans le magasin de santé native. |
openHealthConnectSettings |
Ouvre l'écran de paramètres de Health Connect (disponible uniquement sur Android). Sur iOS, cette méthode ne fait rien. |
showPrivacyPolicy |
Affiche la politique de confidentialité de l'application pour Health Connect (disponible uniquement sur Android). Sur iOS, cette méthode ne fait rien. |
queryWorkouts |
Interroge les sessions d'entraînement à partir du magasin de santé native. Supporté sur iOS (HealthKit) et Android (Health Connect). |
queryAggregated |
Interroge les données de santé agrégées à partir du magasin de santé native. Agrège les données en blocs de temps (heure, jour, semaine, mois) avec des opérations comme somme, moyenne, minimum ou maximum. Cela est plus efficace que de récupérer des échantillons individuels pour de grandes plages de dates. |
Exemples
isAvailable()
Indique si la plateforme actuelle prend en charge la santé native SDK.
import { Health } from '@capgo/capacitor-health';
const result = await Health.isAvailable();
console.log(result);
requestAuthorization()
Accédez aux données fournies en lecture/écriture.
import { Health } from '@capgo/capacitor-health';
const result = await Health.requestAuthorization({ read: ['steps'] });
console.log(result);
checkAuthorization()
Vérifiez l'état d'autorisation pour les données fournies sans solliciter l'utilisateur.
import { Health } from '@capgo/capacitor-health';
const result = await Health.checkAuthorization({ read: ['steps'] });
console.log(result);
readSamples()
Lisez des échantillons pour le type de données spécifié dans la période de temps indiquée.
import { Health } from '@capgo/capacitor-health';
const result = await Health.readSamples({ dataType: 'steps' });
console.log(result);
saveSample()
Écrivez un échantillon unique dans le magasin de santé natif.
import { Health } from '@capgo/capacitor-health';
await Health.saveSample({
dataType: 'steps',
value: 1,
});
openHealthConnectSettings()
Ouvrez l'écran de paramètres de Health Connect (disponible uniquement sur Android). Sur iOS, cette méthode ne fait rien.
import { Health } from '@capgo/capacitor-health';
await Health.openHealthConnectSettings();
Les méthodes ci-dessus sont listées. Les aides pour les listeners et les versions, ainsi que le contrat complet de chaque méthode, sont documentés dans le répertoire GitHub.
Référence complète
Continuez à partir de l'utilisation de @capgo/capacitor-health
If vous utilisez En utilisant @capgo/capacitor-health pour planifier le travail de plugin natif, connectez-l’avec @capgo/capacitor-santé pour les détails d'implémentation dans @capgo/capacitor-health, Prise en main pour les détails d'implémentation dans Prise en main, Répertoire des plugins Capgo pour le flux de travail du produit dans Répertoire des plugins Capgo, Plugins Capacitor par Capgo pour les détails d'implémentation dans Plugins Capacitor par Capgo, et Ajouter ou mettre à jour des plugins pour les détails d'implémentation dans l'ajout ou la mise à jour des plugins.