สภาวะทางจิตใจ — รูปแบบการส่งออก 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 Zend(String): เวลาสิ้นสุด รูปแบบyyyy-MM-dd HH:mm:ss Zkind(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 เก่ากว่านี้ ประเภทข้อมูลนี้จะไม่ปรากฏในการส่งออก
กรณีใช้งาน
ข้อมูลสภาวะทางจิตใจช่วยได้ใน:
- การติดตามอารมณ์: วิเคราะห์แนวโน้มสุขภาวะทางอารมณ์
- การวิเคราะห์ความสัมพันธ์: เข้าใจความเชื่อมโยงระหว่างกิจกรรมกับอารมณ์
- การเฝ้าระวังสุขภาพจิต: ติดตามการเปลี่ยนแปลงสภาวะทางอารมณ์
- ข้อมูลเพื่อสุขภาวะ: ระบุปัจจัยที่ส่งผลดีหรือไม่ดีต่อสภาวะจิตใจ