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ää tietoja mielialasta, emotionaalisesta valenssista, tunnisteista ja assosiaatioista:

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

Kentät

Merkinnän kentät

• id (String): Mielentilamerkinnän yksilöivä tunniste
• start (String): Alkuaika ISO 8601 -aikaleimana, esimerkiksi 2024-02-06T22:00:00Z
• end (String): Lopetusaika ISO 8601 -aikaleimana, esimerkiksi 2024-02-06T22:05:00Z
• kind (String): Merkinnän tyyppi: daily_mood tai momentary_emotion
• labels (Array): Tilaasi kuvaavat tunnisteet, pienillä kirjaimilla, kuten calm, anxious, happy tai stressed
• associations (Array): Tilaasi liittyvät kontekstit, pienillä kirjaimilla tai snake-casessa, kuten work, fitness, family, current_events tai self_care
• valence (Number): Emotionaalinen valenssi välillä -1.0 (erittäin epämiellyttävä) – 1.0 (erittäin miellyttävä)
• valenceClassification (String): Valenssin luokitus: very_unpleasant, unpleasant, slightly_unpleasant, neutral, slightly_pleasant, pleasant tai very_pleasant
• metadata (Object<String, String>, valinnainen): Merkintään liitetty merkkijonometa. Kenttä jätetään pois, kun metadataa ei ole.

Valenssin ymmärtäminen

Valenssi kuvaa mielentilasi emotionaalista laatua:

• Negatiivinen valenssi (arvot lähempänä -1.0): Epämiellyttävät tai kielteiset tunnetilat
• Neutraali valenssi (arvot noin 0.0): Neutraalit tunnetilat
• Positiivinen valenssi (arvot lähempänä 1.0): Miellyttävät tai myönteiset tunnetilat

Merkkijono valenceClassification antaa kategorian, kun taas valence tarjoaa tarkemman numeerisen arvon.

Tunnisteet ja assosiaatiot

• Tunnisteet kuvaavat, miltä sinusta tuntuu (esimerkiksi calm, anxious, happy tai stressed)
• Assosiaatiot antavat kontekstin siitä, mitä olit tekemässä tai mikä vaikutti tilaasi (esimerkiksi work, fitness, friends tai family)

Esimerkkimerkintä

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

Tämä merkintä osoittaa:

• Erittäin miellyttävän hetkellisen tunteen valenssilla 0.8
• Innostuneen ja toiveikkaan olon
• Yhteyden fitnessiin ja itsestä huolehtimiseen
• Tallennuksen kello 08:00 UTC

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