스마트 홈 MediaState 트레잇 스키마

action.devices.traits.MediaState - 이 트레잇은 미디어 상태를 보고할 수 있는 기기에 사용됩니다.

MediaState 트레잇은 다음과 같은 목적으로 어시스턴트에서 사용됩니다.

• 재생이 어시스턴트에서 시작되었는지 여부와 각 기기에서 재생 중인 항목을 확인합니다. 이 정보는 어시스턴트가 사용자 의도를 더 잘 이해하는 데 도움이 됩니다. 예를 들어 사용자의 실제 의도는 '지금 재생 중인 투나잇 쇼 일시중지'인데 '투나잇 쇼 일시중지'라고 말하는 경우가 있습니다.
• 미디어 플레이어 간 이동성: 어시스턴트가 재생 중인 콘텐츠와 현재 재생 위치를 알고 있으면 사용자가 방 간에 이동할 때 어시스턴트가 해당 재생을 다른 기기로 전송하거나 나중에 임의의 기기에서 재생을 저장할 수 있습니다.

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

기기 속성

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

속성	유형	설명
supportActivityState	Boolean	(기본값: false) 기기가 활동 상태를 보고할 수 있는지 여부를 나타냅니다.
supportPlaybackState	Boolean	(기본값: false) 기기가 현재 재생 상태를 보고할 수 있는지 나타냅니다.

예

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

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

기기 상태

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

주	유형	설명
activityState	String	기기가 활성 상태이고 사용자가 기기와 활발하게 상호작용하는지 여부를 나타냅니다. 지원되는 값: INACTIVE STANDBY ACTIVE
playbackState	String	미디어 재생 시 현재 상태를 나타냅니다. 지원되는 값: PAUSED PLAYING FAST_FORWARDING REWINDING BUFFERING STOPPED

예

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

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

기기 명령어

없음

기기 오류

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