HealthyApps Help Center

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: August 26, 2026

Nesta página

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

Campos

Campos da entrada

  • id (String): Identificador exclusivo da entrada de Estado de Espírito
  • start (String): Hora de início como carimbo de data/hora ISO 8601, por exemplo 2024-02-06T22:00:00Z
  • end (String): Hora de término como carimbo de data/hora ISO 8601, por exemplo 2024-02-06T22:05:00Z
  • kind (String): Tipo de entrada: daily_mood ou momentary_emotion
  • labels (Array): Rótulos que descrevem seu estado, com valores em minúsculas como calm, anxious, happy ou stressed
  • associations (Array): Contextos associados ao seu estado, com valores em minúsculas ou snake-case como work, fitness, family, current_events ou self_care
  • valence (Number): Valência emocional de -1.0 (muito desagradável) a 1.0 (muito agradável)
  • valenceClassification (String): Classificação da valência: very_unpleasant, unpleasant, slightly_unpleasant, neutral, slightly_pleasant, pleasant ou very_pleasant
  • metadata (Object<String, String>, opcional): Metadados de texto anexados à entrada. O campo é omitido quando não há metadados.

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 string valenceClassification fornece uma categoria, enquanto valence oferece um valor numérico mais preciso.

Rótulos e Associações

  • Rótulos descrevem como você está se sentindo (por exemplo, calm, anxious, happy ou stressed)
  • Associações fornecem contexto sobre o que você estava fazendo ou o que influenciou seu estado (por exemplo, work, fitness, friends ou family)

Exemplo de Entrada

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

Esta entrada indica:

  • Uma emoção momentânea muito agradável com valência de 0.8
  • Sentir-se animado e esperançoso
  • Associado a fitness e autocuidado
  • Registrado às 08:00 UTC

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