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

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

Last updated: February 6, 2026

On this page

심리 상태

심리 상태 데이터는 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 버전을 사용하는 경우 이 데이터 유형은 내보내기에서 사용할 수 없습니다.

사용 사례

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

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

관련 문서