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

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	Целое число	Необходимый. Количество миллисекунд прямого (положительное 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	логический	Необходимый. 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": {}
}

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

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