心理状态 - 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:00 记录

可用性

心理状态导出在 iOS 18.0 及更高版本中可用。如果您使用的是较旧的 iOS 版本,此数据类型将不会在您的导出中可用。

用例

心理状态数据可用于:

  • 情绪追踪:分析您随时间变化的情绪健康模式
  • 相关性分析:理解活动与情绪之间的关系
  • 心理健康监测:追踪情绪状态的变化
  • 健康洞察:识别有助于积极或消极状态的因素

相关文档