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 stavustart(String): Čas začátku záznamu ve formátuyyyy-MM-dd HH:mm:ss Zend(String): Čas konce záznamu ve formátuyyyy-MM-dd HH:mm:ss Zkind(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