Mielentila

Mielentiladata sisältää Apple Healthiin tallentamasi mielialan ja henkisen tilan merkinnät. Ominaisuus on käytettävissä iOS 18.0:ssa ja uudemmissa. JSON-vienneissä mielentilamerkinnät tallennetaan taulukkoon stateOfMind.

Rakenne

Jokainen mielentilamerkintä sisältää tiedot mielialasta, emotionaalisesta valenssista, tunnisteista ja assosiaatioista:

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

Kentät

Pakolliset kentät

• id (String): Yksilöllinen tunniste mielentilamerkinnälle
• start (String): Merkinnän alkuaika muodossa yyyy-MM-dd HH:mm:ss Z
• end (String): Merkinnän loppuaika muodossa yyyy-MM-dd HH:mm:ss Z
• kind (String): Mielentilamerkinnän tyyppi (tyypillisesti "mood")
• labels (Array): Taulukko tunnisteita tilasi kuvaamiseksi (esim. "Calm", "Anxious", "Happy", "Stressed")
• associations (Array): Taulukko assosiaatioita tai konteksteja (esim. "Work", "Exercise", "Family")
• valence (Number): Emotionaalinen valenssi, tyypillisesti välillä -1.0 (erittäin negatiivinen) – 1.0 (erittäin positiivinen)
• valenceClassification (Number): Valenssin luokitus:
  • -1: Erittäin negatiivinen
  • 0: Neutraali
  • 1: Erittäin positiivinen
• metadata (ObjectString:String): Lisämetatiedot avain–arvo -pareina

Valenssin ymmärtäminen

Valenssi kuvaa mielentilasi emotionaalista laatua:

• Negatiivinen valenssi (arvot lähellä -1.0): Epämiellyttäviä tai negatiivisia tunnetiloja
• Neutraali valenssi (arvot noin 0.0): Neutraaleja tunnetiloja
• Positiivinen valenssi (arvot lähellä 1.0): Miellyttäviä tai positiivisia tunnetiloja

valenceClassification antaa yksinkertaistetun luokituksen, kun taas valence tarjoaa tarkemman numeerisen arvon.

Tunnisteet ja assosiaatiot

• Tunnisteet kuvaavat, miltä sinusta tuntuu (esim. "Calm", "Anxious", "Energetic", "Tired")
• Assosiaatiot antavat kontekstia siitä, mitä teit tai mikä vaikutti tilaasi (esim. "Work", "Exercise", "Social", "Sleep")

Esimerkkimerkintä

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

Tämä merkintä tarkoittaa:

• Positiivista mielialaa (valenssi 0.8, luokitus 1)
• Tunnetta energisyydestä ja motivaatiosta
• Yhteyttä aamurutiiniin ja liikuntaan
• Tallennus klo 8:00

Saatavuus

Mielentilan vienti on käytettävissä iOS 18.0 ja uudemmilla. Vanhemmalla iOS-versiolla tämä datatyyppi ei ole käytettävissä vienneissäsi.

Käyttötapaukset

Mielentiladata voi olla hyödyllistä:

• Mielialan seuranta: Tunne- ja hyvinvointikuvioiden analysointi ajan mittaan
• Korrelaatioanalyysi: Yhteyksien ymmärtäminen aktiviteettien ja mielialan välillä
• Mielenterveysseuranta: Tunnetilojen muutosten seuraaminen
• Hyvinvointinäkemykset: Tekijöiden tunnistaminen, jotka edistävät positiivisia tai negatiivisia tiloja

Liittyvä dokumentaatio

• JSON-viennin muoto – yleiskatsaus
• Manuaalinen vienti
• Automaatiot – yleiskatsaus