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 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-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 único 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 fim 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): Etiquetas que descrevem o 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 associados à entrada. O campo é omitido quando não existem metadados.

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

Etiquetas e Associações

  • Etiquetas descrevem como se sente (por exemplo, calm, anxious, happy ou stressed)
  • Associações fornecem contexto sobre o que estava a fazer ou o que influenciou o 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 uma valência de 0.8
  • Sentir-se entusiasmado e esperançoso
  • Associado a fitness e autocuidado
  • Registado à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 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