스마트 홈 MediaState 트레잇 스키마

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

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

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

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

기기 ATTRIBUTES

이 특성이 있는 기기는 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"
}

기기 명령어

없음.

기기 오류

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