心理狀態

心理狀態資料會擷取您在 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 匯出格式概述
• 手動匯出指南
• 自動化概述