Stato d'Animo - Formato di Esportazione JSON

Documentazione sulla struttura dello stato d'animo nelle esportazioni JSON

Last updated: February 6, 2026

On this page

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

Campi

Campi Richiesti

  • id (String): Identificatore univoco per la voce dello Stato d'Animo
  • start (String): Ora di inizio della voce nel formato yyyy-MM-dd HH:mm:ss Z
  • end (String): Ora di fine della voce nel formato yyyy-MM-dd HH:mm:ss Z
  • kind (String): Tipo di voce dello Stato d'Animo (tipicamente "mood")
  • labels (Array): Array di etichette che descrivono il tuo stato (es. "Calm", "Anxious", "Happy", "Stressed")
  • associations (Array): Array di associazioni o contesti (es. "Work", "Exercise", "Family")
  • valence (Number): Valutazione della valenza emotiva, tipicamente compresa tra -1.0 (molto negativo) e 1.0 (molto positivo)
  • valenceClassification (Number): Classificazione della valenza:
    • -1: Molto negativo
    • 0: Neutrale
    • 1: Molto positivo
  • metadata (ObjectString:String): Metadati aggiuntivi come coppie chiave-valore

Comprendere la Valenza

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

  • Valenza negativa (valori più vicini a -1.0): Stati emotivi spiacevoli o negativi
  • Valenza neutrale (valori intorno a 0.0): Stati emotivi neutrali
  • Valenza positiva (valori più vicini a 1.0): Stati emotivi piacevoli o positivi

La valenceClassification fornisce una categorizzazione semplificata, mentre valence offre un valore numerico più preciso.

Etichette e Associazioni

  • Etichette descrivono come ti senti (es. "Calm", "Anxious", "Energetic", "Tired")
  • Associazioni forniscono contesto su cosa stavi facendo o cosa ha influenzato il tuo stato (es. "Work", "Exercise", "Social", "Sleep")

Esempio di Voce

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

Questa voce indica:

  • Uno stato d'umore positivo (valenza 0.8, classificazione 1)
  • Sentirsi energico e motivato
  • Associato alla routine mattutina e all'esercizio
  • Registrato alle 8:00

Disponibilità

L'esportazione dello Stato d'Animo è disponibile su iOS 18.0 e versioni successive. Se stai usando una versione iOS precedente, 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
  • Insight sul benessere: Identificare i fattori che contribuiscono a stati positivi o negativi

Documentazione Correlata