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

action.devices.traits.Channel - Этот трейт относится к устройствам, поддерживающим телеканалы на медиаустройстве.

Доступные каналы следует предоставлять в виде списка для каждого пользователя или устройства во время синхронизации через атрибут availableChannels . Этот список должен включать все популярные каналы, на которые подписан пользователь или устройство. Для обеспечения низкой задержки запросов рекомендуется использовать небольшой список каналов (не более 30 каналов).

АТРИБУТЫ УСТРОЙСТВА

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

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

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

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

[ item, ... ] Объект

Доступный медиаканал.

key Нить

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

Уникальный идентификатор для этого канала. Недоступен для пользователей.

names Множество

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

Список имен пользователей, видимых для этого канала.

[ item, ... ] Нить

Название канала.

number Нить

Необязательный числовой идентификатор для этого канала.

commandOnlyChannels Логический

(По умолчанию: false )

Указывает, поддерживает ли устройство одностороннюю (true) или двустороннюю (false) связь. Установите для этого атрибута значение true, если устройство не может ответить на запрос QUERY или Report State для этого параметра.

Примеры

Устройство, поддерживающее два канала.

{
  "availableChannels": [
    {
      "key": "ktvu2",
      "names": [
        "Fox",
        "KTVU"
      ],
      "number": "2"
    },
    {
      "key": "abc1",
      "names": [
        "ABC",
        "ABC East"
      ],
      "number": "4-11"
    }
  ]
}

СОСТОЯНИЯ УСТРОЙСТВА

Никто.

КОМАНДЫ УСТРОЙСТВА

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

action.devices.commands.selectChannel

Установите для текущего канала определенное значение.

Параметры

Полезная нагрузка содержит один из следующих компонентов:

Выберите канал по ID

Параметры Тип Описание
channelCode Нить

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

Уникальный идентификатор запрошенного канала, соответствующий одному из availableChannels каналов.

channelName Нить

Удобное для пользователя название запрошенного канала.

channelNumber Нить

Числовой идентификатор запрошенного канала.

Выберите канал по номеру

Параметры Тип Описание
channelNumber Нить

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

Числовой идентификатор запрошенного канала.

Примеры

Переключиться на KTVU

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelCode": "ktvu2",
    "channelName": "KTVU"
  }
}

Переключитесь на третий канал.

{
  "command": "action.devices.commands.selectChannel",
  "params": {
    "channelNumber": "3"
  }
}

Произошла ошибка при выборе нового канала на устройстве.

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

noAvailableChannel
noChannelSubscription
channelSwitchFailed

action.devices.commands.relativeChannel

Отрегулируйте текущий канал на относительную величину.

Параметры

Параметры Тип Описание
relativeChannelChange Целое число

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

Количество каналов, которое нужно увеличить или уменьшить.

Примеры

Переключиться на следующий канал

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": 1
  }
}

Переключиться на предыдущий канал

{
  "command": "action.devices.commands.relativeChannel",
  "params": {
    "relativeChannelChange": -1
  }
}

Произошла ошибка при настройке канала устройства.

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

channelSwitchFailed

action.devices.commands.returnChannel

Вернуться на последний канал, на котором пользователь находился.

Параметры

Параметры Тип Описание

Нет объектов недвижимости

Примеры

Вернуться на последний канал

{
  "command": "action.devices.commands.returnChannel",
  "params": {}
}

Произошла ошибка при возврате к последнему каналу устройства.

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

channelSwitchFailed

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

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