심리 상태 - 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_emotionlabels(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_pleasantmetadata(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 버전을 사용하는 경우 이 데이터 유형은 내보내기에서 사용할 수 없습니다.
사용 사례
심리 상태 데이터는 다음에 유용할 수 있습니다.
- 기분 추적: 시간에 따른 감정적 웰빙 패턴 분석
- 상관 분석: 활동과 기분 간의 관계 이해
- 정신 건강 모니터링: 감정 상태 변화 추적
- 웰니스 인사이트: 긍정적 또는 부정적 상태에 기여하는 요인 식별