스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

스마트 홈 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"
}

기기 명령어

없음.

기기 오류

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