心理状态 - JSON 导出格式
JSON 导出中心理状态结构的文档
Last updated: February 6, 2026
心理状态
心理状态数据捕获您在 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 Zend(String): 条目的结束时间,格式为yyyy-MM-dd HH:mm:ss Zkind(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 版本,此数据类型将不会在您的导出中可用。
用例
心理状态数据可用于:
- 情绪追踪:分析您随时间变化的情绪健康模式
- 相关性分析:理解活动与情绪之间的关系
- 心理健康监测:追踪情绪状态的变化
- 健康洞察:识别有助于积极或消极状态的因素