心理状态

心理状态数据会捕获您在 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 导出格式概述
• 手动导出指南
• 自动化概述