HealthyApps Help Center

Stato d'Animo - Formato di Esportazione JSON

Documentazione sulla struttura dello stato d'animo nelle esportazioni JSON

Last updated: August 26, 2026

In questa pagina

Stato d'Animo

I dati dello Stato d'Animo catturano le tue voci di umore e stato mentale registrate in Apple Health. Questa funzionalità è disponibile su iOS 18.0 e versioni successive. Nelle esportazioni JSON, le voci dello Stato d'Animo sono memorizzate nell'array stateOfMind.

Struttura

Ogni voce dello Stato d'Animo include informazioni sul tuo umore, valenza emotiva, etichette e associazioni:

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

Campi

Campi della voce

  • id (String): Identificatore univoco della voce di Stato d'Animo
  • start (String): Ora di inizio come timestamp ISO 8601, ad esempio 2024-02-06T22:00:00Z
  • end (String): Ora di fine come timestamp ISO 8601, ad esempio 2024-02-06T22:05:00Z
  • kind (String): Tipo di voce: daily_mood o momentary_emotion
  • labels (Array): Etichette che descrivono il tuo stato, con valori in minuscolo come calm, anxious, happy o stressed
  • associations (Array): Contesti associati al tuo stato, con valori in minuscolo o snake-case come work, fitness, family, current_events o self_care
  • valence (Number): Valenza emotiva da -1.0 (molto sgradevole) a 1.0 (molto piacevole)
  • valenceClassification (String): Classificazione della valenza: very_unpleasant, unpleasant, slightly_unpleasant, neutral, slightly_pleasant, pleasant o very_pleasant
  • metadata (Object<String, String>, facoltativo): Metadati testuali associati alla voce. Il campo viene omesso quando non sono disponibili metadati.

Comprendere la Valenza

La valenza rappresenta la qualità emotiva del tuo stato d'animo:

  • Valenza negativa (valori più vicini a -1.0): Stati emotivi sgradevoli o negativi
  • Valenza neutra (valori intorno a 0.0): Stati emotivi neutri
  • Valenza positiva (valori più vicini a 1.0): Stati emotivi piacevoli o positivi

La stringa valenceClassification fornisce una categoria, mentre valence offre un valore numerico più preciso.

Etichette e Associazioni

  • Etichette descrivono come ti senti (ad esempio, calm, anxious, happy o stressed)
  • Associazioni forniscono il contesto su cosa stavi facendo o cosa ha influenzato il tuo stato (ad esempio, work, fitness, friends o family)

Esempio di Voce

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

Questa voce indica:

  • Un'emozione momentanea molto piacevole con una valenza di 0.8
  • Sentirsi eccitati e pieni di speranza
  • Associato a fitness e cura di sé
  • Registrato alle 08:00 UTC

Disponibilità

L'esportazione dello Stato d'Animo è disponibile su iOS 18.0 e versioni successive. Se usi una versione precedente di iOS, questo tipo di dati non sarà disponibile nelle tue esportazioni.

Casi d'Uso

I dati dello Stato d'Animo possono essere utili per:

  • Monitoraggio dell'umore: Analizzare i modelli del tuo benessere emotivo nel tempo
  • Analisi di correlazione: Comprendere le relazioni tra attività e umore
  • Monitoraggio della salute mentale: Tracciare i cambiamenti nello stato emotivo
  • Approfondimenti sul benessere: Identificare i fattori che contribuiscono a stati positivi o negativi

Documentazione Correlata