스마트 홈 작업을 개발하는 방법을 알아볼 수 있는 새로운 공간인 Google Home 개발자 센터에 오신 것을 환영합니다. 참고: Actions 콘솔에서 작업을 계속 만들 수 있습니다.
컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

스마트 홈 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 정수

필수.

찾는 순차 시간 (양수 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": {}
}

기기 오류

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