心理狀態

心理狀態資料會擷取您在 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:00 記錄

可用性

心理狀態匯出在 iOS 18.0 及更高版本中可用。如果您使用的是較舊的 iOS 版本，此資料類型將不會在您的匯出中可用。

使用案例

心理狀態資料可用於：

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

相關文件

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