心の状態

心の状態データは、Apple Health に記録された気分と精神状態のエントリを捉えます。この機能は iOS 18.0 以降で利用できます。JSON エクスポートでは、心の状態のエントリは stateOfMind 配列に保存されます。

構造

各エントリには、気分、感情の価値（valence）、ラベル、関連付けに関する情報が含まれます。

{
  "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): 心の状態エントリの一意識別子
• 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): 状態に関連する文脈。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 に記録されたこと

可用性

心の状態のエクスポートは iOS 18.0 以降 で利用可能です。古い iOS バージョンを使用している場合、このデータタイプはエクスポートで利用できません。

使用例

心の状態データは次の用途に役立ちます。

• 気分の追跡: 時間の経過に伴う感情的な幸福感のパターンの分析
• 相関分析: 活動と気分の間の関係の理解
• メンタルヘルスの監視: 感情状態の変化の追跡
• ウェルネスの洞察: 肯定的または否定的な状態に寄与する要因の特定

関連ドキュメント

• JSONエクスポート形式の概要
• 手動エクスポートガイド
• 自動化の概要