tv

Обновлено 5 ноября 2024

Телевизор.

Доступные функции устройства

У устройства могут быть все нижеперечисленные функции или только часть из них. Например, если телевизор не поддерживает переключение на предыдущий и следующий канал, добавлять функцию channel в описание его модели не нужно.

У устройства есть две обязательные функции: online, on_off. Они должны быть у всех телевизоров.

Функция	Обязательная?	Описание
channel		Переключение на предыдущий или следующий канал
channel_int		Номер канала
custom_key		Кнопка, нажатая на пульте управления
direction		Сдвиг курсора в нужном направлении
mute		Бесшумный режим
number		Нажатая на пульте цифровая кнопка
source		Источник видеосигнала
volume		Сделать тише или громче
volume_int		Уровень громкости
on_off	✔︎	Удаленное включение и выключение устройства
online	✔︎	Доступность устройства: офлайн или онлайн

Пример описания модели телевизора

Модель описывается в соответствии со структурой model. В примере описан телевизор, который обладает всеми функциями.

У модели изменены доступные значения для функции source (источник видеосигнала): этот телевизор не поддерживает функцию демонстрации экрана смартфона или компьютера (ScreenCast), поэтому она исключена.

{
   "id": "QWERTY124",
   "manufacturer": "Xiaqara",
   "model": "SM1123456789",
   "hw_version": "3.1",
   "sw_version": "5.6",
   "description": "Умный телевизор Xiaqara",
   "category": "tv",
   "features": [
      "channel",
      "channel_int",
      "custom_key",
      "direction",
      "mute",
      "number",
      "source",
      "volume",
      "volume_int",      
      "on_off",
      "online"
   ],
   "allowed_values": {
      "source": {
         "type": "ENUM",
         "enum_values": {
            "values": [
                "hdmi1",
                "hdmi2",
                "hdmi3",
                "tv",
                "av",
                "content",
                "+",
                "-"
            ]
         }
      }
   }
}

Пример описания телевизора пользователя

Устройство описывается в соответствии со структурой device. В примере нет описания модели телевизора — считаем, что модели описаны отдельно, поэтому достаточно указать только ID модели (здесь — QWERTY124).

{
   "id": "ABCD_004",
   "name": "Мой телевизор",
   "default_name": "Умный телевизор",
   "nicknames": ["Смарт-телевизор", "Телевизор с ассистентом"],
   "home": "Мой дом",
   "room": "Гостиная",
   "groups": ["Видеотехника", "Электроприборы"],
   "model_id": "QWERTY124",
   "hw_version": "3.1",
   "sw_version": "5.6",
   "partner_meta": {
      "internal-id": 1234,
      "specificity": "microchip 2A"
   },
}