Keadaan minda — format eksport JSON

Dokumentasi untuk struktur keadaan minda dalam eksport JSON

Last updated: August 26, 2026

Pada halaman ini

Keadaan minda

Data Keadaan minda merakam entri mood dan keadaan mental anda dalam Apple Health. Ciri ini tersedia pada iOS 18.0 dan ke atas. Dalam eksport JSON, entri Keadaan minda disimpan dalam tatasusunan stateOfMind.

Struktur

Setiap entri Keadaan minda merangkumi maklumat tentang mood, valens emosi, label dan perkaitan:

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

Medan

Medan entri

  • id (String): Pengenal unik untuk entri Keadaan minda
  • start (String): Masa mula sebagai cap masa ISO 8601, contohnya 2024-02-06T22:00:00Z
  • end (String): Masa tamat sebagai cap masa ISO 8601, contohnya 2024-02-06T22:05:00Z
  • kind (String): Jenis entri: daily_mood atau momentary_emotion
  • labels (Array): Label yang menerangkan keadaan anda, menggunakan nilai huruf kecil seperti calm, anxious, happy atau stressed
  • associations (Array): Konteks yang dikaitkan dengan keadaan anda, menggunakan nilai huruf kecil atau snake-case seperti work, fitness, family, current_events atau self_care
  • valence (Number): Valens emosi dari -1.0 (sangat tidak menyenangkan) hingga 1.0 (sangat menyenangkan)
  • valenceClassification (String): Pengelasan valens: very_unpleasant, unpleasant, slightly_unpleasant, neutral, slightly_pleasant, pleasant atau very_pleasant
  • metadata (Object<String, String>, pilihan): Metadata teks yang dilampirkan pada entri. Medan ditinggalkan apabila tiada metadata.

Memahami valens

Valens mewakili kualiti emosi keadaan minda anda:

  • Valens negatif (nilai lebih hampir kepada -1.0): Keadaan emosi yang tidak menyenangkan atau negatif
  • Valens neutral (nilai sekitar 0.0): Keadaan emosi neutral
  • Valens positif (nilai lebih hampir kepada 1.0): Keadaan emosi yang menyenangkan atau positif

Rentetan valenceClassification menyediakan kategori, manakala valence menawarkan nilai berangka yang lebih tepat.

Label dan perkaitan

  • Label menerangkan perasaan anda (contohnya calm, anxious, happy atau stressed)
  • Perkaitan memberikan konteks tentang apa yang anda lakukan atau apa yang mempengaruhi keadaan anda (contohnya work, fitness, friends atau family)

Contoh entri

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

Entri ini menunjukkan:

  • Emosi seketika yang sangat menyenangkan dengan valens 0.8
  • Berasa teruja dan penuh harapan
  • Dikaitkan dengan kecergasan dan penjagaan diri
  • Direkodkan pada 08:00 UTC

Ketersediaan

Eksport Keadaan minda tersedia pada iOS 18.0 dan ke atas. Jika anda menggunakan versi iOS lebih lama, jenis data ini tidak tersedia dalam eksport anda.

Kes penggunaan

Data Keadaan minda berguna untuk:

  • Penjejakan mood: Menganalisis corak kesejahteraan emosi anda mengikut masa
  • Analisis korelasi: Memahami hubungan antara aktiviti dan mood
  • Pemantauan kesihatan mental: Menjejaki perubahan dalam keadaan emosi
  • Wawasan kesejahteraan: Mengenal pasti faktor yang menyumbang kepada keadaan positif atau negatif

Dokumentasi berkaitan