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 stavu
  • start (String): Čas začátku jako časové razítko ISO 8601, například 2024-02-06T22:00:00Z
  • end (String): Čas konce jako časové razítko ISO 8601, například 2024-02-06T22:05:00Z
  • kind (String): Typ záznamu: daily_mood nebo momentary_emotion
  • labels (Array): Štítky popisující váš stav, s hodnotami malými písmeny, například calm, anxious, happy nebo stressed
  • associations (Array): Kontexty spojené se stavem, s hodnotami malými písmeny nebo ve snake-case, například work, fitness, family, current_events nebo self_care
  • valence (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, pleasant nebo very_pleasant
  • metadata (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, happy nebo stressed)
  • Asociace poskytují kontext, co jste dělali nebo co ovlivnilo váš stav (například work, fitness, friends nebo family)

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

Související dokumentace