État d'Esprit - Format d'Exportation JSON

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

Last updated: February 6, 2026

On this 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-06 14:00:00 -0800",
  "end": "2024-02-06 14:05:00 -0800",
  "kind": "mood",
  "labels": ["Calm", "Focused"],
  "associations": ["Work", "Productive"],
  "valence": 0.7,
  "valenceClassification": 1,
  "metadata": {
    "customKey": "customValue"
  }
}

Champs

Champs Requis

  • id (String) : Identifiant unique pour l'entrée d'État d'Esprit
  • start (String) : Heure de début de l'entrée au format yyyy-MM-dd HH:mm:ss Z
  • end (String) : Heure de fin de l'entrée au format yyyy-MM-dd HH:mm:ss Z
  • kind (String) : Type d'entrée d'État d'Esprit (généralement "mood")
  • labels (Array) : Tableau d'étiquettes décrivant votre état (p. ex., "Calm", "Anxious", "Happy", "Stressed")
  • associations (Array) : Tableau d'associations ou de contextes (p. ex., "Work", "Exercise", "Family")
  • valence (Number) : Note de valence émotionnelle, généralement comprise entre -1.0 (très négatif) et 1.0 (très positif)
  • valenceClassification (Number) : Classification de la valence :
    • -1 : Très négatif
    • 0 : Neutre
    • 1 : Très positif
  • metadata (ObjectString:String) : Métadonnées supplémentaires sous forme de paires clé-valeur

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 valenceClassification fournit une catégorisation simplifiée, tandis que valence offre une valeur numérique plus précise.

Étiquettes et Associations

  • Étiquettes décrivent ce que vous ressentez (p. ex., "Calm", "Anxious", "Energetic", "Tired")
  • Associations fournissent un contexte sur ce que vous faisiez ou ce qui a influencé votre état (p. ex., "Work", "Exercise", "Social", "Sleep")

Exemple d'Entrée

{
  "id": "abc123-def456-ghi789",
  "start": "2024-02-06 08:00:00 -0800",
  "end": "2024-02-06 08:05:00 -0800",
  "kind": "mood",
  "labels": ["Energetic", "Motivated"],
  "associations": ["Morning Routine", "Exercise"],
  "valence": 0.8,
  "valenceClassification": 1,
  "metadata": {}
}

Cette entrée indique :

  • Un état d'humeur positif (valence 0.8, classification 1)
  • Se sentir énergique et motivé
  • Associé à la routine matinale et à l'exercice
  • Enregistré à 8h00

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