심리 상태 - JSON 내보내기 형식

JSON 내보내기에서 심리 상태 구조에 대한 문서

Last updated: August 26, 2026

이 페이지에서

심리 상태

심리 상태 데이터는 Apple Health에 기록된 기분 및 정신 상태 항목을 캡처합니다. 이 기능은 iOS 18.0 이상에서 사용할 수 있습니다. JSON 내보내기에서 심리 상태 항목은 stateOfMind 배열에 저장됩니다.

구조

각 심리 상태 항목에는 기분, 정서적 가치(valence), 레이블 및 연관성에 대한 정보가 포함됩니다.

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

필드

항목 필드

  • id (String): 심리 상태 항목의 고유 식별자
  • start (String): ISO 8601 타임스탬프로 나타낸 시작 시간(예: 2024-02-06T22:00:00Z)
  • end (String): ISO 8601 타임스탬프로 나타낸 종료 시간(예: 2024-02-06T22:05:00Z)
  • kind (String): 항목 유형: daily_mood 또는 momentary_emotion
  • labels (Array): 상태를 설명하는 레이블. calm, anxious, happy, stressed와 같은 소문자 값
  • associations (Array): 상태와 관련된 맥락. work, fitness, family, current_events, self_care와 같은 소문자 또는 스네이크 케이스 값
  • valence (Number): -1.0(매우 불쾌)에서 1.0(매우 유쾌)까지의 정서적 가치
  • valenceClassification (String): 가치 분류: very_unpleasant, unpleasant, slightly_unpleasant, neutral, slightly_pleasant, pleasant 또는 very_pleasant
  • metadata (Object<String, String>, 선택): 항목에 첨부된 문자열 메타데이터. 메타데이터가 없으면 필드가 생략됩니다.

가치 이해하기

가치는 심리 상태의 정서적 품질을 나타냅니다.

  • 부정적인 가치(-1.0에 가까운 값): 불쾌하거나 부정적인 감정 상태
  • 중립적인 가치(0.0 근처의 값): 중립적인 감정 상태
  • 긍정적인 가치(1.0에 가까운 값): 유쾌하거나 긍정적인 감정 상태

valenceClassification 문자열은 범주를 제공하고, valence는 더 정확한 숫자 값을 제공합니다.

레이블 및 연관성

  • 레이블은 기분이 어떤지를 설명합니다(예: calm, anxious, happy, stressed)
  • 연관성은 무엇을 하고 있었는지 또는 상태에 영향을 준 것에 대한 맥락을 제공합니다(예: work, fitness, friends, family)

항목 예시

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

이 항목은 다음을 나타냅니다.

  • 가치 0.8의 매우 유쾌한 순간 감정
  • 흥분되고 희망찬 기분
  • 피트니스 및 자기 관리와의 연관
  • 08:00 UTC에 기록됨

사용 가능성

심리 상태 내보내기는 iOS 18.0 이상에서 사용할 수 있습니다. 이전 iOS 버전을 사용하는 경우 이 데이터 유형은 내보내기에서 사용할 수 없습니다.

사용 사례

심리 상태 데이터는 다음에 유용할 수 있습니다.

  • 기분 추적: 시간에 따른 감정적 웰빙 패턴 분석
  • 상관 분석: 활동과 기분 간의 관계 이해
  • 정신 건강 모니터링: 감정 상태 변화 추적
  • 웰니스 인사이트: 긍정적 또는 부정적 상태에 기여하는 요인 식별

관련 문서