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

기기 ERRORS

전체 목록 보기 오류 및 예외를 방지합니다.