Duševní stav - formát exportu JSON
Dokumentace ke struktuře duševního stavu v exportech JSON.
Last updated: August 26, 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ě, emoční valenci, štítcích a asociacích:
{
"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"
}
}
Pole
Pole záznamu
id(String): Jedinečný identifikátor záznamu duševního stavustart(String): Čas začátku jako časové razítko ISO 8601, například2024-02-06T22:00:00Zend(String): Čas konce jako časové razítko ISO 8601, například2024-02-06T22:05:00Zkind(String): Typ záznamu:daily_moodnebomomentary_emotionlabels(Array): Štítky popisující váš stav, s hodnotami malými písmeny, například calm,anxious,happynebostressedassociations(Array): Kontexty spojené se stavem, s hodnotami malými písmeny nebo ve snake-case, například work,fitness,family,current_eventsneboself_carevalence(Number): Emoční valence od -1.0 (velmi nepříjemná) do 1.0 (velmi příjemná)valenceClassification(String): Klasifikace valence:very_unpleasant,unpleasant,slightly_unpleasant,neutral,slightly_pleasant,pleasantnebovery_pleasantmetadata(Object<String, String>, volitelné): Textová metadata připojená k záznamu. Pole se vynechá, pokud metadata nejsou k dispozici.
Pochopení valence
Valence představuje emoční kvalitu vašeho duševního stavu:
- Záporná valence (hodnoty blíže k -1.0): Nepříjemné nebo negativní emoční stavy
- Neutrální valence (hodnoty kolem 0.0): Neutrální emoční stavy
- Kladná valence (hodnoty blíže k 1.0): Příjemné nebo pozitivní emoční stavy
Řetězec valenceClassification poskytuje kategorii, zatímco valence nabízí přesnější číselnou hodnotu.
Štítky a asociace
- Štítky popisují, jak se cítíte (například
calm,anxious,happynebostressed) - Asociace poskytují kontext, co jste dělali nebo co ovlivnilo váš stav (například
work,fitness,friendsnebofamily)
Příklad záznamu
{
"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": {}
}
Tento záznam naznačuje:
- Velmi příjemnou okamžitou emoci s valencí 0.8
- Pocit vzrušení a naděje
- Spojení s fitness a péčí o sebe
- Zaznamenáno v 08:00 UTC
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ů emocionální pohody v čase
- Analýzu korelací: 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