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

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

Last updated: August 26, 2026

ในหน้านี้

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

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

โครงสร้าง

แต่ละรายการสภาวะทางจิตใจมีข้อมูลเกี่ยวกับอารมณ์ ค่า valence อารมณ์ ป้ายกำกับ และความเชื่อมโยง:

{
  "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"
  }
}

ฟิลด์

ฟิลด์ของรายการ

  • id (String): ตัวระบุเฉพาะของรายการสภาวะทางจิตใจ
  • start (String): เวลาเริ่มต้นเป็นตราประทับเวลา ISO 8601 เช่น 2024-02-06T22:00:00Z
  • end (String): เวลาสิ้นสุดเป็นตราประทับเวลา ISO 8601 เช่น 2024-02-06T22:05:00Z
  • kind (String): ประเภทของรายการ: daily_mood หรือ momentary_emotion
  • labels (Array): ป้ายกำกับที่อธิบายสภาวะ โดยใช้ค่าตัวพิมพ์เล็ก เช่น calm, anxious, happy หรือ stressed
  • associations (Array): บริบทที่เชื่อมกับสภาวะ โดยใช้ค่าตัวพิมพ์เล็กหรือ snake-case เช่น work, fitness, family, current_events หรือ self_care
  • valence (Number): ค่า valence อารมณ์ตั้งแต่ -1.0 (ไม่พึงประสงค์มาก) ถึง 1.0 (พึงประสงค์มาก)
  • valenceClassification (String): การจัดประเภท valence: very_unpleasant, unpleasant, slightly_unpleasant, neutral, slightly_pleasant, pleasant หรือ very_pleasant
  • metadata (Object<String, String>, ไม่บังคับ): เมทาดาทาข้อความที่แนบกับรายการ ฟิลด์จะถูกละไว้เมื่อไม่มีเมทาดาทา

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

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

  • Valence เชิงลบ (ค่าใกล้ -1.0): สภาวะอารมณ์ที่ไม่พึงประสงค์หรือเชิงลบ
  • Valence เป็นกลาง (ค่าใกล้ 0.0): สภาวะอารมณ์เป็นกลาง
  • Valence เชิงบวก (ค่าใกล้ 1.0): สภาวะอารมณ์ที่พึงประสงค์หรือเชิงบวก

สตริง valenceClassification ให้หมวดหมู่ ในขณะที่ valence ให้ค่าตัวเลขที่ละเอียดกว่า

ป้ายกำกับและความเชื่อมโยง

  • ป้ายกำกับ อธิบายความรู้สึก (เช่น calm, anxious, happy หรือ stressed)
  • ความเชื่อมโยง ให้บริบทว่าคุณกำลังทำอะไร หรือสิ่งใดมีผลต่อสภาวะ (เช่น work, fitness, friends หรือ family)

ตัวอย่างรายการ

{
  "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": {}
}

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

  • อารมณ์ชั่วขณะที่พึงประสงค์มาก โดยมี valence 0.8
  • รู้สึกตื่นเต้นและมีความหวัง
  • เชื่อมกับฟิตเนสและการดูแลตนเอง
  • บันทึกเวลา 08:00 UTC

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

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

กรณีใช้งาน

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

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

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