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

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

Last updated: April 5, 2026

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

Стан настрою

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

Структура

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

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

Поля

Обов’язкові поля

id (String): унікальний ідентифікатор запису State of Mind
start (String): час початку запису у форматі yyyy-MM-dd HH:mm:ss Z
end (String): час завершення запису у форматі yyyy-MM-dd HH:mm:ss Z
kind (String): тип запису State of Mind (зазвичай "mood")
labels (Array): масив міток, що описують ваш стан (наприклад, "Calm", "Anxious", "Happy", "Stressed")
associations (Array): масив асоціацій або контекстів (наприклад, "Work", "Exercise", "Family")
valence (Number): оцінка емоційної валентності, зазвичай у діапазоні від -1.0 (дуже негативно) до 1.0 (дуже позитивно)
valenceClassification (Number): класифікація валентності:
- -1: дуже негативно
- 0: нейтрально
- 1: дуже позитивно
metadata (ObjectString:String): додаткові метадані у вигляді пар ключ–значення

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

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

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

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

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

Мітки описують, як ви себе почуваєте (наприклад, "Calm", "Anxious", "Energetic", "Tired")
Асоціації дають контекст — чим ви займалися або що вплинуло на ваш стан (наприклад, "Work", "Exercise", "Social", "Sleep")

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

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

Цей запис показує:

позитивний настрій (valence 0.8, classification 1)
відчуття бадьорості та мотивації
зв’язок із ранковою рутиною та вправами
запис о 8:00 ранку

Доступність

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

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

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

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