Duševní stav - formát exportu JSON

Dokumentace ke struktuře duševního stavu v exportech JSON.

Last updated: February 6, 2026

Na této stránce

Duševní stav

Data duševního stavu zachycují záznamy nálady a psychického stavu uložené v Apple Health. Tato funkce je k dispozici na iOS 18.0 a novějších. V JSON exportech jsou záznamy uloženy v poli stateOfMind.

Struktura

Každý záznam duševního stavu obsahuje informace o náladě, emocionální valenci, štítcích a asociacích:

{
  "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"
  }
}

Pole

Povinná pole

  • id (String): Jedinečný identifikátor záznamu duševního stavu
  • start (String): Čas začátku záznamu ve formátu yyyy-MM-dd HH:mm:ss Z
  • end (String): Čas konce záznamu ve formátu yyyy-MM-dd HH:mm:ss Z
  • kind (String): Typ záznamu duševního stavu (obvykle "mood")
  • labels (Array): Pole štítků popisujících váš stav (např. „Calm“, „Anxious“, „Happy“, „Stressed“)
  • associations (Array): Pole asociací nebo kontextů (např. „Work“, „Exercise“, „Family“)
  • valence (Number): Hodnocení emocionální valence, obvykle od -1.0 (velmi negativní) do 1.0 (velmi pozitivní)
  • valenceClassification (Number): Klasifikace valence:
    • -1: Velmi negativní
    • 0: Neutrální
    • 1: Velmi pozitivní
  • metadata (ObjectString:String): Další metadata jako páry klíč–hodnota

Pochopení valence

Valence představuje emocionální kvalitu vašeho duševního stavu:

  • Negativní valence (hodnoty blíže -1.0): nepříjemné nebo negativní emoční stavy
  • Neutrální valence (hodnoty kolem 0.0): neutrální emoční stavy
  • Pozitivní valence (hodnoty blíže 1.0): příjemné nebo pozitivní emoční stavy

valenceClassification poskytuje zjednodušenou kategorizaci, zatímco valence přesnější číselnou hodnotu.

Štítky a asociace

  • Štítky popisují, jak se cítíte (např. „Calm“, „Anxious“, „Energetic“, „Tired“)
  • Asociace poskytují kontext o tom, co jste dělali nebo co ovlivnilo váš stav (např. „Work“, „Exercise“, „Social“, „Sleep“)

Příklad záznamu

{
  "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": {}
}

Tento záznam ukazuje:

  • pozitivní náladu (valence 0.8, klasifikace 1)
  • pocit energie a motivace
  • souvislost s ranní rutinou a cvičením
  • zaznamenáno v 8:00

Dostupnost

Export duševního stavu je k dispozici na iOS 18.0 a novějších. Na starší verzi iOS tento datový typ v exportech nebude k dispozici.

Případy použití

Data duševního stavu mohou být užitečná pro:

  • Sledování nálady: analýzu vzorců emoční pohody v čase
  • Korelační analýzu: vztahy mezi aktivitami a náladou
  • Sledování psychického zdraví: změny emocionálního stavu
  • Poznatky o wellness: faktory přispívající k pozitivním nebo negativním stavům

Související dokumentace