Стан настрою — формат експорту JSON

Документація щодо структури State of Mind у JSON-експортах

Last updated: August 26, 2026

На цій сторінці

Стан настрою

Дані State of Mind фіксують записи настрою та психічного стану в Apple Health. Ця функція доступна на iOS 18.0 і новіших версіях. У JSON-експортах записи State of Mind зберігаються в масиві stateOfMind.

Структура

Кожен запис містить відомості про настрій, емоційну валентність, мітки та асоціації:

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

Поля

Поля запису

id (String): Унікальний ідентифікатор запису State of Mind
start (String): Час початку як позначка часу ISO 8601, наприклад 2024-02-06T22:00:00Z
end (String): Час завершення як позначка часу ISO 8601, наприклад 2024-02-06T22:05:00Z
kind (String): Тип запису: daily_mood або momentary_emotion
labels (Array): Мітки, що описують стан, зі значеннями в нижньому регістрі, як-от calm, anxious, happy або stressed
associations (Array): Контексти, пов’язані зі станом, зі значеннями в нижньому регістрі або snake-case, як-от work, fitness, family, current_events або self_care
valence (Number): Емоційна валентність від -1.0 (дуже неприємна) до 1.0 (дуже приємна)
valenceClassification (String): Класифікація валентності: very_unpleasant, unpleasant, slightly_unpleasant, neutral, slightly_pleasant, pleasant або very_pleasant
metadata (Object<String, String>, необов’язково): Текстові метадані, приєднані до запису. Поле пропускається, якщо метаданих немає.

Розуміння валентності

Валентність відображає емоційну якість стану настрою:

Від’ємна валентність (значення ближчі до -1.0): неприємні або негативні емоційні стани
Нейтральна валентність (значення близько 0.0): нейтральні емоційні стани
Додатна валентність (значення ближчі до 1.0): приємні або позитивні емоційні стани

Рядок valenceClassification задає категорію, а valence дає точніше числове значення.

Мітки та асоціації

Мітки описують, як ви себе почуваєте (наприклад, calm, anxious, happy або stressed)
Асоціації дають контекст того, що ви робили або що вплинуло на стан (наприклад, work, fitness, friends або family)

Приклад запису

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

Цей запис означає:

Дуже приємну миттєву емоцію з валентністю 0.8
Відчуття захоплення та надії
Зв’язок із фітнесом і турботою про себе
Запис о 08:00 UTC

Доступність

Експорт State of Mind доступний на iOS 18.0 і новіших. Якщо ви використовуєте старішу версію iOS, цей тип даних не буде доступний у ваших експортах.

Сценарії використання

Дані State of Mind можуть бути корисні для:

Відстеження настрою: аналіз закономірностей емоційного самопочуття з часом
Кореляційний аналіз: розуміння зв’язків між активностями та настроєм
Моніторинг психічного здоров’я: відстеження змін емоційного стану
Інсайти для самопочуття: виявлення факторів, що сприяють позитивним або негативним станам