스마트 홈 TransportControl 트레잇 스키마
action.devices.traits.TransportControl
- 이 트레잇은 미디어 재생을 제어할 수 있는 기기 (예: 일시중지된 음악을 재개)에 사용됩니다.
기기 속성
이 트레잇이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
transportControlSupportedCommands |
배열 |
필수사항. 이 기기에서 지원되는 전송 제어 명령어를 설명하는 문자열 목록입니다. |
[item, ...] |
String |
지원되는 명령어 지원되는 값:
|
예
재생 명령어를 지원하는 기기
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
기기 상태
없음
기기 명령어
이 트레잇이 있는 기기는 EXECUTE
작업의 일부로 다음 명령어에 응답할 수 있습니다. EXECUTE
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
action.devices.commands.mediaStop
미디어 재생을 일시중지합니다.
이 명령어에는 다음 속성이 필요합니다.{ "transportControlSupportedCommands": [ "STOP" ] }
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
속성이 없습니다. |
예
매개변수 없음
{ "command": "action.devices.commands.mediaStop", "params": {} }
action.devices.commands.mediaNext
다음 미디어 항목으로 건너뜁니다.
이 명령어에는 다음 속성이 필요합니다.{ "transportControlSupportedCommands": [ "NEXT" ] }
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
속성이 없습니다. |
예
매개변수 없음
{ "command": "action.devices.commands.mediaNext", "params": {} }
action.devices.commands.mediaPrevious
이전 미디어 항목으로 건너뜁니다.
이 명령어에는 다음 속성이 필요합니다.{ "transportControlSupportedCommands": [ "PREVIOUS" ] }
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
속성이 없습니다. |
예
매개변수 없음
{ "command": "action.devices.commands.mediaPrevious", "params": {} }
action.devices.commands.mediaPause
미디어 재생을 일시중지합니다.
이 명령어에는 다음 속성이 필요합니다.{ "transportControlSupportedCommands": [ "PAUSE" ] }
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
속성이 없습니다. |
예
매개변수 없음
{ "command": "action.devices.commands.mediaPause", "params": {} }
action.devices.commands.mediaResume
미디어 재생을 다시 시작합니다.
이 명령어에는 다음 속성이 필요합니다.{ "transportControlSupportedCommands": [ "RESUME" ] }
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
속성이 없습니다. |
예
매개변수 없음
{ "command": "action.devices.commands.mediaResume", "params": {} }
action.devices.commands.mediaSeekRelative
상대 위치로 이동합니다.
이 명령어에는 다음 속성이 필요합니다.{ "transportControlSupportedCommands": [ "SEEK_RELATIVE" ] }
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
relativePositionMs |
정수 |
필수사항. 앞으로 (양의 정수) 또는 뒤로 (음의 정수) 이동할 밀리초입니다. |
예
10초 앞으로 이동
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": 10000 } }
10초 뒤로 탐색
{ "command": "action.devices.commands.mediaSeekRelative", "params": { "relativePositionMs": -10000 } }
action.devices.commands.mediaSeekToPosition
절대 위치로 이동합니다.
이 명령어에는 다음 속성이 필요합니다.{ "transportControlSupportedCommands": [ "SEEK_TO_POSITION" ] }
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
absPositionMs |
정수 |
필수사항. 탐색할 절대 위치의 밀리초입니다. |
예
30초 앞으로 이동
{ "command": "action.devices.commands.mediaSeekToPosition", "params": { "absPositionMs": 30000 } }
action.devices.commands.mediaRepeatMode
반복 재생 모드를 설정합니다.
이 명령어에는 다음 속성이 필요합니다.{ "transportControlSupportedCommands": [ "SET_REPEAT" ] }
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
isOn |
Boolean |
필수사항. 반복 모드를 사용 설정하려면 true, 사용 중지하려면 false입니다. |
isSingle |
Boolean |
(기본값: 지정된 경우 true는 단일 항목 반복 모드를 사용 설정하는 것이고 false는 일반 반복 모드 (예: 재생목록)를 사용 설정하는 것입니다. |
예
반복 날짜
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true } }
반복 사용 안함
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": false } }
단일 트랙 반복
{ "command": "action.devices.commands.mediaRepeatMode", "params": { "isOn": true, "isSingle": true } }
action.devices.commands.mediaShuffle
현재 재생목록을 셔플합니다.
이 명령어에는 다음 속성이 필요합니다.{ "transportControlSupportedCommands": [ "SHUFFLE" ] }
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
속성이 없습니다. |
예
매개변수 없음
{ "command": "action.devices.commands.mediaShuffle", "params": {} }
action.devices.commands.mediaClosedCaptioningOn
자막을 사용 설정합니다.
이 명령어에는 다음 속성이 필요합니다.{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
closedCaptioningLanguage |
String |
자막의 언어 또는 언어 옵션입니다. |
userQueryLanguage |
String |
사용자 검색어의 언어 또는 언어입니다. |
예
영어 자막 사용 설정하기
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "en" } }
한국어 자막 사용하기
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR" } }
미국 영어로 된 사용자 쿼리로 한국어 자막 사용 설정하기
{ "command": "action.devices.commands.mediaClosedCaptioningOn", "params": { "closedCaptioningLanguage": "ko-KR", "userQueryLanguage": "en-US" } }
action.devices.commands.mediaClosedCaptioningOff
자막을 사용 중지합니다.
이 명령어에는 다음 속성이 필요합니다.{ "transportControlSupportedCommands": [ "CAPTION_CONTROL" ] }
매개변수
매개변수 | 유형 | 설명 |
---|---|---|
속성이 없습니다. |
예
자막 사용 중지
{ "command": "action.devices.commands.mediaClosedCaptioningOff", "params": {} }