สภาวะทางจิตใจ — รูปแบบการส่งออก JSON

เอกสารโครงสร้างสภาวะทางจิตใจในการส่งออก JSON

Last updated: April 5, 2026

ในหน้านี้

สภาวะทางจิตใจ

ข้อมูลสภาวะทางจิตใจบันทึกอารมณ์และสภาวะจิตใจใน Apple Health ฟีเจอร์นี้มีใน iOS 18.0 ขึ้นไป ในการส่งออก JSON รายการสภาวะทางจิตใจอยู่ในอาร์เรย์ stateOfMind

โครงสร้าง

แต่ละรายการรวมอารมณ์ ค่า valence ป้ายกำกับ และความเชื่อมโยง:

{
  "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): คะแนน valence ทางอารมณ์ โดยทั่วไปจาก -1.0 (ลบมาก) ถึง 1.0 (บวกมาก)
  • valenceClassification (Number): การจำแนก valence:
    • -1: ลบมาก
    • 0: เป็นกลาง
    • 1: บวกมาก
  • metadata (ObjectString:String): เมทาดาทาเพิ่มเติมเป็นคู่คีย์-ค่า

ความหมายของ Valence

Valence แทนคุณภาพทางอารมณ์ของสภาวะจิตใจ:

  • Valence ลบ (ใกล้ -1.0): อารมณ์ไม่พึงประสงค์หรือลบ
  • Valence เป็นกลาง (ราว 0.0): อารมณ์เป็นกลาง
  • Valence บวก (ใกล้ 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": {}
}

รายการนี้บ่งชี้:

  • อารมณ์บวก (valence 0.8, classification 1)
  • รู้สึกกระฉับกระเฉงและมีแรงจูงใจ
  • เชื่อมกับกิจวัตรเช้าและการออกกำลังกาย
  • บันทึกเวลา 8:00 น.

ความพร้อมใช้งาน

การส่งออกสภาวะทางจิตใจมีใน iOS 18.0 ขึ้นไป หากใช้ iOS เก่ากว่านี้ ประเภทข้อมูลนี้จะไม่ปรากฏในการส่งออก

กรณีใช้งาน

ข้อมูลสภาวะทางจิตใจช่วยได้ใน:

  • การติดตามอารมณ์: วิเคราะห์แนวโน้มสุขภาวะทางอารมณ์
  • การวิเคราะห์ความสัมพันธ์: เข้าใจความเชื่อมโยงระหว่างกิจกรรมกับอารมณ์
  • การเฝ้าระวังสุขภาพจิต: ติดตามการเปลี่ยนแปลงสภาวะทางอารมณ์
  • ข้อมูลเพื่อสุขภาวะ: ระบุปัจจัยที่ส่งผลดีหรือไม่ดีต่อสภาวะจิตใจ

เอกสารที่เกี่ยวข้อง