Les sessions permettent aux utilisateurs d'afficher rapidement et facilement une liste des principales activités qu'ils ont effectuées. Elles apparaissent sur la page du journal de l'application Google Fit. Par exemple, une session de respiration, une marche, une course à pied ou une nuit de sommeil sont deux exemples de sessions.
Les sessions regroupent des ensembles de données issus d'une période spécifique, qui ont été collectés lors d'une activité. Par exemple, si un utilisateur effectue le suivi au début et à la fin d'une course de 3 km, il est possible de créer une session et d'associer toutes les données d'activité physique enregistrées au cours de cette période (pas, vitesse, distance, etc.).
Les sessions elles-mêmes ne contiennent pas de détails sur l'activité. Il se trouve dans l'ensemble de données. Les sessions ont les propriétés suivantes:
- Nom descriptif descriptif (par exemple, "course du lendemain")
- Une description
- Un identifiant unique
- Type d'activité capturée (par exemple, une course)
Avantages des sessions
- Utile pour les utilisateurs : les sessions vous aident à organiser les données d'activité et les entraînements de manière pertinente. Ils peuvent consulter toutes leurs activités de la journée sur la page "Journal" de l'application Google Fit.
- Expérience utilisateur cohérente: si votre application ou votre appareil associé permet le suivi de l'activité (où les utilisateurs peuvent démarrer et arrêter une activité), la pratique de sessions d'entraînement permet aux utilisateurs de voir leur activité dans les deux applications.
- Données plus complètes: Google Fit fusionne également les données de plusieurs sources pour compléter et enrichir les informations de votre session. Les utilisateurs bénéficient ainsi d'un aperçu plus complet de leur activité.
- Exploitez la plate-forme Google Fit : si vos utilisateurs ne suivent pas leur activité, ou si votre application ne propose pas le suivi, vous pouvez toujours lire les sessions dans Google Fit. Vous pouvez interroger des données détaillées ou agrégées à partir du magasin de remise en forme et rechercher les sessions disponibles, sans avoir à implémenter votre propre schéma et stockage.
- Renforcement de l'engagement utilisateur: vous pouvez présenter aux utilisateurs les sessions disponibles et les applications qui les ont créées. Interagir avec d'autres applications de fitness de cette manière peut accroître l'engagement des utilisateurs.
Obtenir l'autorisation des utilisateurs pour les sessions
Si vous souhaitez lire ou écrire des sessions, votre application doit obtenir l'autorisation de l'utilisateur. L'accès aux sessions utilise les mêmes champs d'application d'autorisation que les types de données, que vous devez demander comme suit:
Android
Spécifiez le type de session auquel votre application doit accéder, à l'aide des méthodes appropriées de FitnessOptions
.
Par exemple, pour lire les sessions de course à pied, vous pouvez choisir:
val fitnessOptions = FitnessOptions.builder()
.accessActivitySessions(FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_HEART_RATE_BPM, FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_SPEED, FitnessOptions.ACCESS_READ)
.addDataType(DataType.TYPE_LOCATION_SAMPLE, FitnessOptions.ACCESS_READ)
.build()
Cet exemple indique que votre application souhaite accéder aux métadonnées de session d'activité, et spécifie également les types de données qu'il souhaite lire dans ces sessions. Les types de données de fréquence cardiaque, de vitesse et de localisation sont utilisés dans cet exemple.
REST
Champs d'application de la requête:
- Sessions avec types d'activités de sommeil :
https://www.googleapis.com/auth/fitness.sleep.read
https://www.googleapis.com/auth/fitness.sleep.write
- Toutes les autres sessions :
https://www.googleapis.com/auth/fitness.activity.read
https://www.googleapis.com/auth/fitness.activity.write
Utiliser des sessions
Android
Vous pouvez utiliser l'API Sessions pour:
- Créer des sessions en temps réel
- Insérer des sessions dans la boutique de fitness
- Insérer des segments d'activité pour permettre les pauses pendant les entraînements
- Lire les sessions et les ensembles de données qui leur sont associés
- Lancer une autre application pour afficher des informations sur une session qu'elle a créée
- Recevoir un intent lorsqu'une autre application démarre une session
REST
Vous pouvez utiliser l'API Sessions pour:
- Créer des sessions en temps réel
- Insérer des sessions dans la boutique de fitness
- Insérer des segments d'activité pour permettre les pauses pendant les entraînements
- Lire les sessions et les ensembles de données qui leur sont associés
Interactions des ensembles de données et des segments avec les sessions
Dans Google Fit:
- Un ensemble de données représente un ensemble de points de données d'une source de données spécifique sur une période spécifique. Les ensembles de données peuvent être insérés de leur propre côté. Toutefois, si vous créez une session, il peut être plus simple de créer simultanément la session et ses ensembles de données.
- Un segment regroupe les ensembles de données d'une session en fonction de l'activité exacte de l'utilisateur au cours de cette session. Par exemple, si l'utilisateur suit une session de 30 minutes (la session) mais qu'il a marché pendant un certain temps au cours de celle-ci, il peut être divisé en segments. Il y aura un segment pour la course, la pause pour la marche, puis la course à nouveau.
La figure 1 montre un intervalle de temps dans le magasin de fitness au cours duquel les applications A, B et C ont inséré des ensembles de données et des sessions:
- L'application A a inséré les ensembles de données A1 et A2 en même temps que les sessions 1 et A3, indépendamment de toute session.
- L'application B a inséré les ensembles de données B1 et B2 avec la session 2.
- L'application C a inséré l'ensemble de données C1 indépendamment de toute session.
Lorsque vous lisez les données de session du magasin de remise en forme, toutes les données de remise en forme qui se trouvent dans l'intervalle d'une session sont automatiquement associées à cette session, même si vous insérez les données après la création de la session ou si vous créez une session après le suivi des données de manière passive. Par exemple, une requête pour les données de remise en forme de la session 1 renvoie:
- Ensemble de données A1
- Ensemble de données A2
- La partie de l'ensemble de données A3 située entre t1 et t2
- La partie de l'ensemble de données C1 située entre t1 et t2
Vous pouvez identifier l'application qui a inséré chaque session et ensemble de données.
Créer des sessions
Vous pouvez créer des sessions de différentes manières:
- Votre application peut créer activement une session dans :
- en temps réel lorsqu'un utilisateur suit activement une activité sur un appareil (Android uniquement).
- en l'insérant manuellement.
- Lorsqu'un utilisateur ajoute manuellement une séance de sport ou une activité dans l'application Google Fit.
Quand créer une session
Ajoutez-vous des données de sommeil ?
- Oui : créez une session et insérez-la manuellement dans ce magasin. Par exemple, vous pouvez insérer une session de sommeil. En effet, les utilisateurs disposant d'applications ou d'appareils de suivi du sommeil n'interagissent pas avec les appareils pour démarrer et arrêter leur activité liée au sommeil (suivi effectué de façon passive).
- Non : votre application permet-elle aux utilisateurs de démarrer et d'arrêter des activités ?
- Non : ne créez pas de session. Ajoutez uniquement des ensembles de données depuis votre application.
- Oui - Avec l'API Android, créez une session en temps réel si les utilisateurs suivent leur activité ou manuellement. Avec l'API REST, créez une session et insérez-la manuellement dans le magasin de remise en forme.
- Votre application peut-elle détecter lorsqu'un utilisateur effectue des activités différentes à un niveau plus détaillé (par exemple, marcher ou courir) ?
- Oui : ajoutez des segments.
- Non : permet uniquement d'ajouter des ensembles de données. Ignorez les segments pour le moment et laissez Google Fit les créer de manière passive.
Sessions de lecture
Votre application peut lire des sessions de plusieurs manières:
- Recherchez une session spécifique créée ou insérée par
- Nom ou
- ID
- Rechercher toutes les sessions qu'il a créées/insérées, par période
- Rechercher toutes les sessions disponibles créées par toutes les applications (y compris Google Fit) par période
Identifier les sources qui ont créé une session
Vous pouvez indiquer à vos utilisateurs l'application ou l'appareil à l'origine de chacune de leurs sessions. Chaque session est associée à une source de données, qui contient des informations sur l'application ou l'appareil qui a collecté ou transformé les données.
Android
Actuellement, vous ne pouvez obtenir que le nom de package d'une session écrite par un client Android. Pour obtenir le nom de package de l'application qui a créé une session, utilisez la méthode getAppPackageName
. Vous pouvez utiliser ces informations dans votre application pour indiquer aux utilisateurs quelles autres applications ont inséré des sessions de remise en forme. Vous pouvez afficher l'icône de chacune de ces applications pour aider les utilisateurs à les identifier.
Vous pouvez également déclencher un intent pour lancer d'autres applications afin d'afficher les détails des sessions qu'elles ont créées. D'autres applications peuvent également déclencher une intention de lancement de votre application.
Découvrez comment trouver la source qui a créé une session.
REST
Pour obtenir le nom de package de l'application Android qui a créé des sessions, utilisez la propriété session.application
. Pour les sessions créées à l'aide de l'API REST, utilisez plutôt la propriété session.name
. Vous pouvez utiliser ces informations dans votre application pour indiquer aux utilisateurs quelles autres applications ont inséré des sessions de remise en forme. Vous pouvez afficher l'icône de chacune de ces applications pour aider les utilisateurs à les identifier.
Découvrez comment trouver la source qui a créé une session.