心理狀態

心理狀態資料會擷取你在 Apple Health 中記錄的情緒和心理狀態項目。此功能在 iOS 18.0 及之後版本可用。在 JSON 匯出中，心理狀態項目會儲存在 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): 心理狀態紀錄的唯一識別碼
• 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

可用性

心理狀態匯出在 iOS 18.0 及之後版本可用。如果你使用較舊的 iOS 版本，此資料類型不會出現在匯出中。

使用案例

心理狀態資料可用於：

• 情緒追蹤：分析你隨時間變化的情緒健康模式
• 相關性分析：理解活動與情緒之間的關係
• 心理健康監測：追蹤情緒狀態的變化
• 健康洞察：識別有助於積極或消極狀態的因素

相關文件

• JSON 匯出格式概述
• 手動匯出指南
• 自動化概述