HealthyApps Help Center

État d'Esprit - Format d'Exportation JSON

Documentation sur la structure de l'état d'esprit dans les exportations JSON

Last updated: August 26, 2026

Sur cette page

État d'Esprit

Les données d'État d'Esprit capturent vos entrées d'humeur et d'état mental enregistrées dans Apple Health. Cette fonctionnalité est disponible sur iOS 18.0 et versions ultérieures. Dans les exportations JSON, les entrées d'État d'Esprit sont stockées dans le tableau stateOfMind.

Structure

Chaque entrée d'État d'Esprit inclut des informations sur votre humeur, la valence émotionnelle, les étiquettes et les associations :

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "start": "2024-02-06T22:00:00Z",
  "end": "2024-02-06T22:05:00Z",
  "kind": "daily_mood",
  "labels": ["calm", "confident"],
  "associations": ["work", "tasks"],
  "valence": 0.7,
  "valenceClassification": "very_pleasant",
  "metadata": {
    "customKey": "customValue"
  }
}

Champs

Champs de l'entrée

  • id (String) : Identifiant unique de l'entrée d'État d'Esprit
  • start (String) : Heure de début au format horodatage ISO 8601, par exemple 2024-02-06T22:00:00Z
  • end (String) : Heure de fin au format horodatage ISO 8601, par exemple 2024-02-06T22:05:00Z
  • kind (String) : Type d'entrée : daily_mood ou momentary_emotion
  • labels (Array) : Étiquettes décrivant votre état, avec des valeurs en minuscules telles que calm, anxious, happy ou stressed
  • associations (Array) : Contextes associés à votre état, avec des valeurs en minuscules ou en snake-case telles que work, fitness, family, current_events ou self_care
  • valence (Number) : Valence émotionnelle allant de -1.0 (très désagréable) à 1.0 (très agréable)
  • valenceClassification (String) : Classification de la valence : very_unpleasant, unpleasant, slightly_unpleasant, neutral, slightly_pleasant, pleasant ou very_pleasant
  • metadata (Object<String, String>, facultatif) : Métadonnées textuelles associées à l'entrée. Le champ est omis lorsqu'aucune métadonnée n'est disponible.

Comprendre la Valence

La valence représente la qualité émotionnelle de votre état d'esprit :

  • Valence négative (valeurs plus proches de -1.0) : États émotionnels désagréables ou négatifs
  • Valence neutre (valeurs autour de 0.0) : États émotionnels neutres
  • Valence positive (valeurs plus proches de 1.0) : États émotionnels agréables ou positifs

La chaîne valenceClassification fournit une catégorie, tandis que valence offre une valeur numérique plus précise.

Étiquettes et Associations

  • Étiquettes décrivent ce que vous ressentez (par exemple, calm, anxious, happy ou stressed)
  • Associations fournissent un contexte sur ce que vous faisiez ou ce qui a influencé votre état (par exemple, work, fitness, friends ou family)

Exemple d'Entrée

{
  "id": "9f4a09ba-3933-4f2a-b165-5c5c76513e99",
  "start": "2024-02-06T08:00:00Z",
  "end": "2024-02-06T08:05:00Z",
  "kind": "momentary_emotion",
  "labels": ["excited", "hopeful"],
  "associations": ["fitness", "self_care"],
  "valence": 0.8,
  "valenceClassification": "very_pleasant",
  "metadata": {}
}

Cette entrée indique :

  • Une émotion momentanée très agréable avec une valence de 0.8
  • Un sentiment d'enthousiasme et d'espoir
  • Une association avec le fitness et le soin de soi
  • Un enregistrement à 08:00 UTC

Disponibilité

L'exportation d'État d'Esprit est disponible sur iOS 18.0 et versions ultérieures. Si vous utilisez une version iOS antérieure, ce type de données ne sera pas disponible dans vos exportations.

Cas d'Usage

Les données d'État d'Esprit peuvent être utiles pour :

  • Suivi de l'humeur : Analyser les modèles de votre bien-être émotionnel au fil du temps
  • Analyse de corrélation : Comprendre les relations entre les activités et l'humeur
  • Surveillance de la santé mentale : Suivre les changements dans l'état émotionnel
  • Perspectives de bien-être : Identifier les facteurs qui contribuent aux états positifs ou négatifs

Documentation Connexe