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 suas entradas de humor e estado mental registradas no Apple Health. Este recurso 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 seu humor, valência emocional, rótulos 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 término 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 rótulos descrevendo 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

Entendendo 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.

Rótulos e Associações

  • Rótulos descrevem como você está se sentindo (ex.: "Calm", "Anxious", "Energetic", "Tired")
  • Associações fornecem contexto sobre o que você estava fazendo ou o que influenciou 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)
  • Sentindo-se energético e motivado
  • Associado à rotina matinal e exercício
  • Registrado às 8:00

Disponibilidade

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

Casos de Uso

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

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

Documentação Relacionada