스마트 홈 MediaState 속성 스키마

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

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

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

이 특성에서 속성을 구성하여 솔루션이 제공하는 미디어 상태의 수준과 측면을 지정할 수 있습니다. 이 특성은 일반적으로 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"
}

기기 명령어

없음.

기기 오류

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