Cette page décrit les principales fonctions de l'API Santé Connect.
Opérations CRUD sur la synchronisation des enregistrements et des données
La plate-forme fournit des fonctions standards d'insertion, d'actualisation et de suppression pour les données enregistrées. Santé Connect comprend également une fonctionnalité qui permet aux applications clientes de synchroniser les données en dehors de Santé Connect. Cette opération crée un journal des modifications apportées aux données indiquant au développeur et à l'utilisateur si certains types de données ont été insérés ou supprimés par d'autres applications.
Fonctions d'agrégation de base
Les clients peuvent appliquer une fonction d'agrégation aux données sous-jacentes en fournissant les éléments suivants:
- Les valeurs moyennes, minimales ou maximales (par exemple, la fréquence cardiaque minimale et maximale au cours d'une session d'activité).
- Le total (par exemple, le nombre total de pas effectués au cours d'une journée).
- Compte simple du nombre de mesures sous-jacentes (par exemple, le nombre de sessions d'activité effectuées au cours d'une semaine donnée).
- La durée totale pour les types de données compatibles (par exemple, la durée totale de sommeil profond au cours d'une semaine ou la durée totale des sessions d'activité effectuées au cours d'une journée).
Vérification de disponibilité
Santé Connect est compatible avec la version 28 (Pie) ou ultérieure du SDK Android. Ce SDK permet aux applications clientes de déterminer si l'API Santé Connect est installée sur l'appareil Android de l'utilisateur. Si ce n'est pas le cas, Santé Connect déclenche une vérification de disponibilité pour déterminer si l'appareil de l'utilisateur est compatible.
Vérifications des autorisations
Santé Connect nécessite que vous demandiez l'autorisation à l'utilisateur de lire et d'écrire ses données de santé et de remise en forme pour chaque application. Cela vous permet également de consulter les autorisations déjà accordées ou refusées par l'utilisateur.
Lecture avec Santé Connect
Lecture au premier plan
Seules les applications exécutées au premier plan peuvent lire des données avec Santé Connect. Cette restriction a pour but de renforcer la confidentialité des données des utilisateurs.
Dans les situations où votre application peut s'attendre à une interruption, par exemple lorsqu'elle affiche une mesure dans votre application, effectuez une lecture directement depuis Santé Connect vers votre application cliente.
Dans les situations où vous préférez que votre application s'exécute sans interruption, par exemple pour lire une plage de données de Santé Connect, puis l'écrire et l'importer ailleurs, utilisez un service de premier plan plutôt qu'une activité qu'il est facile d'ignorer.
Lecture en arrière-plan
Vous pouvez demander à votre application de s'exécuter en arrière-plan et de lire les données de Santé Connect. Si vous demandez l'autorisation Lecture en arrière-plan, votre utilisateur peut autoriser votre application à lire les données en arrière-plan.