Схема признаков TransportControl для умного дома

action.devices.traits.TransportControl — эта черта используется для устройств, которые могут управлять воспроизведением мультимедиа (например, возобновлять воспроизведение музыки во время паузы).

АТРИБУТЫ устройства

Устройства с этой характеристикой могут сообщать следующие атрибуты в рамках операции SYNC . Дополнительные сведения об обработке намерений SYNC см. в разделе Выполнение намерений .

Атрибуты Тип Описание
transportControlSupportedCommands Множество

Необходимый.

Список строк, описывающих поддерживаемые команды управления транспортировкой на этом устройстве.

[ item, ... ] Нить

Поддерживаемые команды.

Поддерживаемые значения:

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 логическое значение

Необходимый.

Значение true для включения режима повтора, значение false для выключения режима повтора.

isSingle логическое значение

(По умолчанию: 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 Нить

Язык или локаль для субтитров.

userQueryLanguage Нить

Язык или локаль для запроса пользователя.

Примеры

Включите субтитры на английском языке.

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

ОШИБКИ устройства

Полный список ошибок и исключений смотрите .