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

action.devices.traits.Channel — эта черта относится к устройствам, которые поддерживают телеканалы на мультимедийном устройстве.

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

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

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

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

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

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

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

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

key Нить

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

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

names Множество

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

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

[ item, ... ] Нить

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

number Нить

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

commandOnlyChannels логический

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

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

Примеры

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

{
  "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 Нить

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

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

Примеры

Сменить на КТВУ

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

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

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