스마트 홈 MediaState 특성 스키마

action.devices.traits.MediaState: 이 특성은 미디어 상태를 보고할 수 있는 기기에 사용됩니다.

MediaState 특성은 어시스턴트가 다음 목적으로 사용합니다.

  • 각 기기에서 재생 중인 콘텐츠가 무엇인지 알아보려면 어시스턴트가 재생을 시작했는지 여부를 확인하세요. 이 정보는 어시스턴트가 사용자 인텐트를 더 잘 이해하는 데 도움이 됩니다. 예를 들어 사용자의 실제 인텐트가 "Pause the device current running the Tonight Show'인 경우 "오늘 밤 프로그램 일시중지해 줘"라고 말합니다.
  • 미디어 플레이어 간의 이동성: 어시스턴트가 현재 재생 중인 항목과 현재 재생 위치를 아는 경우 사용자가 방 사이를 이동할 때 재생을 다른 기기로 전송하거나 나중에 임의 기기에서 재생 항목을 저장할 수 있습니다.

이 특성의 속성을 구성하여 솔루션에서 제공하는 미디어 상태의 수준과 측면을 지정할 수 있습니다. 이 특성은 일반적으로 TransportControl 특성과 함께 사용됩니다.

기기 속성

이 특성이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

속성 유형 설명
supportActivityState Boolean

(기본값: false)

기기에서 활동 상태를 보고할 수 있는지 표시합니다.

supportPlaybackState Boolean

(기본값: false)

기기에서 현재 재생 상태를 보고할 수 있는지 표시합니다.

예시

SYNC 응답의 활동과 재생 상태를 모두 보고하는 미디어 기기

{
  "supportActivityState": true,
  "supportPlaybackState": true
}

기기 상태: STATES

이 특성이 있는 항목은 QUERY 작업의 일부로 다음 상태를 보고할 수 있습니다. QUERY 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

상태 유형 설명
activityState String

기기가 활성 상태이고 사용자가 활발하게 기기와 상호작용 중인지 표시합니다.

지원되는 값:

INACTIVE
STANDBY
ACTIVE
playbackState String

미디어를 재생할 때 현재 상태를 나타냅니다.

지원되는 값:

PAUSED
PLAYING
FAST_FORWARDING
REWINDING
BUFFERING
STOPPED

예시

활동 및 재생 상태를 모두 보고하는 미디어 기기

{
  "activityState": "ACTIVE",
  "playbackState": "PAUSED"
}

기기 COMMANDS

없음

기기 ERRORS

오류 및 예외의 전체 목록을 참조하세요.