Estado de Espírito - Formato de Exportação JSON

Documentação sobre a estrutura do estado de espírito nas exportações JSON

Last updated: February 6, 2026

On this page

Estado de Espírito

Os dados de Estado de Espírito capturam as suas entradas de humor e estado mental registadas no Apple Health. Esta funcionalidade está disponível no iOS 18.0 e versões posteriores. Nas exportações JSON, as entradas de Estado de Espírito são armazenadas no array stateOfMind.

Estrutura

Cada entrada de Estado de Espírito inclui informações sobre o seu humor, valência emocional, etiquetas e associações:

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

Campos

Campos Obrigatórios

  • id (String): Identificador único para a entrada de Estado de Espírito
  • start (String): Hora de início da entrada no formato yyyy-MM-dd HH:mm:ss Z
  • end (String): Hora de fim da entrada no formato yyyy-MM-dd HH:mm:ss Z
  • kind (String): Tipo de entrada de Estado de Espírito (tipicamente "mood")
  • labels (Array): Array de etiquetas que descrevem o seu estado (ex.: "Calm", "Anxious", "Happy", "Stressed")
  • associations (Array): Array de associações ou contextos (ex.: "Work", "Exercise", "Family")
  • valence (Number): Classificação de valência emocional, tipicamente variando de -1.0 (muito negativo) a 1.0 (muito positivo)
  • valenceClassification (Number): Classificação da valência:
    • -1: Muito negativo
    • 0: Neutro
    • 1: Muito positivo
  • metadata (ObjectString:String): Metadados adicionais como pares chave-valor

Compreender a Valência

A valência representa a qualidade emocional do seu estado de espírito:

  • Valência negativa (valores mais próximos de -1.0): Estados emocionais desagradáveis ou negativos
  • Valência neutra (valores em torno de 0.0): Estados emocionais neutros
  • Valência positiva (valores mais próximos de 1.0): Estados emocionais agradáveis ou positivos

A valenceClassification fornece uma categorização simplificada, enquanto valence oferece um valor numérico mais preciso.

Etiquetas e Associações

  • Etiquetas descrevem como se sente (ex.: "Calm", "Anxious", "Energetic", "Tired")
  • Associações fornecem contexto sobre o que estava a fazer ou o que influenciou o seu estado (ex.: "Work", "Exercise", "Social", "Sleep")

Exemplo de Entrada

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

Esta entrada indica:

  • Um estado de humor positivo (valência 0.8, classificação 1)
  • Sentir-se energético e motivado
  • Associado à rotina matinal e exercício
  • Registado às 8:00

Disponibilidade

A exportação de Estado de Espírito está disponível no iOS 18.0 e versões posteriores. Se estiver a usar uma versão anterior do iOS, este tipo de dados não estará disponível nas suas exportações.

Casos de Utilização

Os dados de Estado de Espírito podem ser úteis para:

  • Rastreamento de humor: Analisar padrões no seu bem-estar emocional ao longo do tempo
  • Análise de correlação: Compreender relações entre atividades e humor
  • Monitorização de saúde mental: Rastrear alterações no estado emocional
  • Insights de bem-estar: Identificar fatores que contribuem para estados positivos ou negativos

Documentação Relacionada