Схема признаков управления транспортом умного дома
action.devices.traits.TransportControl
— этот трейт используется для устройств, которые могут управлять воспроизведением мультимедиа (например, возобновлять воспроизведение музыки во время паузы).
АТРИБУТЫ устройства
Устройства с этой чертой могут сообщать о следующих атрибутах как часть операции SYNC
. Дополнительные сведения об обработке намерений SYNC
см. в разделе Выполнение намерений .
Атрибуты | Тип | Описание |
---|---|---|
transportControlSupportedCommands | Множество | Необходимый. Список строк, описывающих поддерживаемые команды управления транспортом на этом устройстве. |
[ item, ... ] | Нить | Поддерживаемые команды. Поддерживаемые значения:
|
Примеры
Устройство, поддерживающее команды воспроизведения
{ "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 | логический | (По умолчанию: Если указано, значение 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": {} }