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ần
  • start (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:00Z
  • end (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:00Z
  • kind (String): Loại mục: daily_mood hoặc momentary_emotion
  • labels (Array): Nhãn mô tả trạng thái, dùng giá trị chữ thường như calm, anxious, happy hoặc stressed
  • associations (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_events hoặc self_care
  • valence (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, pleasant hoặc very_pleasant
  • metadata (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, happy hoặc stressed)
  • 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, friends hoặc family)

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

Tài liệu liên quan