심리 상태 - JSON 내보내기 형식
JSON 내보내기에서 심리 상태 구조에 대한 문서
Last updated: February 6, 2026
심리 상태
심리 상태 데이터는 Apple Health에 기록된 기분 및 정신 상태 항목을 캡처합니다. 이 기능은 iOS 18.0 이상에서 사용할 수 있습니다. JSON 내보내기에서 심리 상태 항목은 stateOfMind 배열에 저장됩니다.
구조
각 심리 상태 항목에는 기분, 감정적 가치, 레이블 및 연관성에 대한 정보가 포함됩니다:
{
"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"
}
}
필드
필수 필드
id(String): 심리 상태 항목의 고유 식별자start(String): 항목의 시작 시간 (yyyy-MM-dd HH:mm:ss Z형식)end(String): 항목의 종료 시간 (yyyy-MM-dd HH:mm:ss Z형식)kind(String): 심리 상태 항목의 유형 (일반적으로"mood")labels(Array): 상태를 설명하는 레이블 배열 (예: "Calm", "Anxious", "Happy", "Stressed") associations(Array): 연관성 또는 컨텍스트 배열 (예: "Work", "Exercise", "Family") valence(Number): 감정적 가치 평가 (일반적으로 -1.0(매우 부정적)에서 1.0(매우 긍정적)까지)valenceClassification(Number): 가치 분류:-1: 매우 부정적0: 중립1: 매우 긍정적
metadata(ObjectString:String): 키-값 쌍으로 추가 메타데이터
가치 이해하기
가치는 심리 상태의 감정적 품질을 나타냅니다:
- 부정적 가치 (-1.0에 가까운 값): 불쾌하거나 부정적인 감정 상태
- 중립적 가치 (0.0 주변 값): 중립적인 감정 상태
- 긍정적 가치 (1.0에 가까운 값): 즐겁거나 긍정적인 감정 상태
valenceClassification은 단순화된 분류를 제공하고, valence는 더 정확한 수치를 제공합니다.
레이블 및 연관성
- 레이블은 현재 느끼는 감정을 설명합니다 (예: "Calm", "Anxious", "Energetic", "Tired")
- 연관성은 수행한 활동이나 상태에 영향을 준 요소에 대한 컨텍스트를 제공합니다 (예: "Work", "Exercise", "Social", "Sleep")
항목 예시
{
"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": {}
}
이 항목은 다음을 나타냅니다:
- 긍정적인 기분 상태 (가치 0.8, 분류 1)
- 활기차고 동기부여된 느낌
- 아침 루틴 및 운동과 연관됨
- 오전 8시에 기록됨
사용 가능성
심리 상태 내보내기는 iOS 18.0 이상에서 사용할 수 있습니다. 이전 iOS 버전을 사용하는 경우 이 데이터 유형은 내보내기에서 사용할 수 없습니다.
사용 사례
심리 상태 데이터는 다음에 유용할 수 있습니다:
- 기분 추적: 시간에 따른 감정적 웰빙 패턴 분석
- 상관 분석: 활동과 기분 간의 관계 이해
- 정신 건강 모니터링: 감정 상태 변화 추적
- 웰니스 인사이트: 긍정적 또는 부정적 상태에 기여하는 요인 식별