Trạng thái tinh thần – Định dạng xuất JSON
Cấu trúc Trạng thái tinh thần trong bản xuất JSON
Last updated: August 26, 2026
Trên trang này
Trạng thái tinh thần
Dữ liệu Trạng thái tinh thần ghi nhận tâm trạng và trạng thái tinh thần trong Apple Health. Có trên iOS 18.0 trở lên. Trong JSON, các mục nằm trong mảng stateOfMind.
Cấu trúc
Mỗi mục gồm tâm trạng, valence cảm xúc, nhãn và ngữ cảnh:
{
"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"
}
}
Trường dữ liệu
Trường của mục
id(String): Định danh duy nhất của mục Trạng thái tinh thầnstart(String): Thời điểm bắt đầu dưới dạng dấu thời gian ISO 8601, ví dụ2024-02-06T22:00:00Zend(String): Thời điểm kết thúc dưới dạng dấu thời gian ISO 8601, ví dụ2024-02-06T22:05:00Zkind(String): Loại mục:daily_moodhoặcmomentary_emotionlabels(Array): Nhãn mô tả trạng thái, dùng giá trị chữ thường như calm,anxious,happyhoặcstressedassociations(Array): Ngữ cảnh gắn với trạng thái, dùng giá trị chữ thường hoặc snake-case như work,fitness,family,current_eventshoặcself_carevalence(Number): Valence cảm xúc từ -1.0 (rất khó chịu) đến 1.0 (rất dễ chịu)valenceClassification(String): Phân loại valence:very_unpleasant,unpleasant,slightly_unpleasant,neutral,slightly_pleasant,pleasanthoặcvery_pleasantmetadata(Object<String, String>, tùy chọn): Siêu dữ liệu dạng chuỗi gắn với mục. Trường bị bỏ qua khi không có siêu dữ liệu.
Hiểu valence
Valence thể hiện chất lượng cảm xúc của trạng thái tinh thần:
- Valence âm (giá trị gần -1.0): trạng thái cảm xúc khó chịu hoặc tiêu cực
- Valence trung tính (giá trị quanh 0.0): trạng thái cảm xúc trung tính
- Valence dương (giá trị gần 1.0): trạng thái cảm xúc dễ chịu hoặc tích cực
Chuỗi valenceClassification cung cấp một nhóm; valence chi tiết hơn bằng số.
Nhãn và liên kết
- Nhãn mô tả cảm giác (ví dụ
calm,anxious,happyhoặcstressed) - Liên kết cung cấp ngữ cảnh về việc bạn đang làm gì hoặc yếu tố ảnh hưởng đến trạng thái (ví dụ
work,fitness,friendshoặcfamily)
Ví dụ
{
"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": {}
}
Mục này cho thấy:
- Cảm xúc tức thời rất dễ chịu với valence 0.8
- Cảm giác hào hứng và lạc quan
- Gắn với thể dục và chăm sóc bản thân
- Ghi lúc 08:00 UTC
Khả dụng
Xuất Trạng thái tinh thần trên iOS 18.0 trở lên. Phiên bản cũ hơn không có loại dữ liệu này trong xuất.
Ứng dụng
- Theo dõi tâm trạng: phân tích xu hướng cảm xúc theo thời gian
- Phân tích tương quan: hiểu mối liên hệ giữa hoạt động và tâm trạng
- Giám sát sức khỏe tinh thần: theo dõi thay đổi trạng thái cảm xúc
- Thông tin sức khỏe toàn diện: xác định yếu tố góp phần vào trạng thái tích cực hoặc tiêu cực