스마트 홈 TransportControl 특성 스키마
action.devices.traits.TransportControl
- 이 특성은 미디어 재생을 제어할 수 있는 기기에 사용됩니다 (예: 일시중지된 상태에서 음악 재개).
기기 속성
이 특성이 있는 기기는 SYNC
작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC
인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.
속성 | 유형 | 설명 |
---|---|---|
transportControlSupportedCommands |
배열 |
필수. 이 기기에서 지원되는 전송 제어 명령어를 설명하는 문자열 목록입니다. |
[item, ...] |
String |
지원되는 명령어 지원되는 값:
|
예시
재생 명령을 지원하는 기기
{ "transportControlSupportedCommands": [ "NEXT", "PREVIOUS", "PAUSE", "STOP", "RESUME" ] }
기기 상태: STATES
없음
기기 COMMANDS
이 특성이 있는 기기는 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 |
정수 |
필수. 찾을 정방향 (양수 int) 또는 역방향 (음수 int) 밀리초입니다. |
예시
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": {} }