心の状態 - JSONエクスポート形式

JSONエクスポートにおける心の状態の構造に関するドキュメント

Last updated: February 6, 2026

On this page

心の状態

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

構造

各心の状態エントリには、気分、感情的な価値、ラベル、関連付けに関する情報が含まれます:

{
  "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): 心の状態エントリの一意の識別子
  • start (String): エントリの開始時刻(形式:yyyy-MM-dd HH:mm:ss Z
  • end (String): エントリの終了時刻(形式:yyyy-MM-dd HH:mm:ss Z
  • kind (String): 心の状態エントリのタイプ(通常は"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": {}
}

このエントリは以下を示しています:

  • 肯定的な気分状態(価値0.8、分類1)
  • エネルギッシュでやる気があると感じる
  • 朝のルーティンと運動に関連付けられている
  • 午前8時に記録された

可用性

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

使用例

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

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

関連ドキュメント