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

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

Доступные каналы должны быть доступны в виде списка для каждого пользователя или устройства во время синхронизации с помощью 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

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

Параметры

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

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

Параметры Тип Описание
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

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

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