สภาวะทางจิตใจ — รูปแบบการส่งออก 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:00Zend(String): เวลาสิ้นสุดเป็นตราประทับเวลา ISO 8601 เช่น2024-02-06T22:05:00Zkind(String): ประเภทของรายการ:daily_moodหรือmomentary_emotionlabels(Array): ป้ายกำกับที่อธิบายสภาวะ โดยใช้ค่าตัวพิมพ์เล็ก เช่น calm,anxious,happyหรือstressedassociations(Array): บริบทที่เชื่อมกับสภาวะ โดยใช้ค่าตัวพิมพ์เล็กหรือ snake-case เช่น work,fitness,family,current_eventsหรือself_carevalence(Number): ค่า valence อารมณ์ตั้งแต่ -1.0 (ไม่พึงประสงค์มาก) ถึง 1.0 (พึงประสงค์มาก)valenceClassification(String): การจัดประเภท valence:very_unpleasant,unpleasant,slightly_unpleasant,neutral,slightly_pleasant,pleasantหรือvery_pleasantmetadata(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 เก่ากว่านี้ ประเภทข้อมูลนี้จะไม่ปรากฏในการส่งออก
กรณีใช้งาน
ข้อมูลสภาวะทางจิตใจช่วยได้ใน:
- การติดตามอารมณ์: วิเคราะห์แนวโน้มสุขภาวะทางอารมณ์
- การวิเคราะห์ความสัมพันธ์: เข้าใจความเชื่อมโยงระหว่างกิจกรรมกับอารมณ์
- การเฝ้าระวังสุขภาพจิต: ติดตามการเปลี่ยนแปลงสภาวะทางอารมณ์
- ข้อมูลเพื่อสุขภาวะ: ระบุปัจจัยที่ส่งผลดีหรือไม่ดีต่อสภาวะจิตใจ