스마트 홈 TransportControl 트레잇 스키마

action.devices.traits.TransportControl - 이 트레잇은 미디어 재생을 제어할 수 있는 기기 (예: 일시중지된 음악을 재개)에 사용됩니다.

기기 속성

이 트레잇이 있는 기기는 SYNC 작업의 일부로 다음 속성을 보고할 수 있습니다. SYNC 인텐트 처리에 관한 자세한 내용은 인텐트 처리를 참고하세요.

속성 유형 설명
transportControlSupportedCommands 배열

필수사항.

이 기기에서 지원되는 전송 제어 명령어를 설명하는 문자열 목록입니다.
[item, ...] String

지원되는 명령어

지원되는 값:

CAPTION_CONTROL
NEXT
PAUSE
PREVIOUS
RESUME
SEEK_RELATIVE
SEEK_TO_POSITION
SET_REPEAT
SHUFFLE
STOP

예

재생 명령어를 지원하는 기기

{
  "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

(기본값: false)

지정된 경우 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": {}
}

기기 오류

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