스마트 홈 TransportControl 특성 스키마

action.devices.traits.TransportControl: 이 특성은 미디어 재생을 제어할 수 있는 기기에 사용됩니다 (예: 일시중지된 상태에서 음악 다시 시작).

기기 ATTRIBUTES

이 특성이 있는 기기는 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 정수

필수사항.

탐색할 정방향(양수 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

(기본값: 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": {}
}

기기 오류

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