Параметры устройств

Настраиваются через раздел entity_config в YAML конфигурации, все параметры являются необязательными.

Обратите внимание

Наличие объекта в entity_config не означает, что он будет передан в УДЯ автоматически. Не забудьте явно разрешить передачу объекта в УДЯ.

Имя и комната¶

Параметры: name и room

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

Пример

yandex_smart_home:
  entity_config:
    switch.dishwasher:
      name: Посудомойка
      room: Кухня

Тип устройства¶

Параметр: type (возможные значения)

Переопределяет автоматически вычисленный тип устройства. Влияет только на визуальную составляющую в "Дом с Алисой" (и глаголы управления). Никак не влияет на функции устройства.

Например, домен switch по умолчанию передаётся как "выключатель" (switch) и реагирует на команду "Алиса, включи ХХХ". Если задать openable, то у такого устройства изменится иконка на дверь и фраза на "Алиса, открой XXX".

Поддерживается как полное, так и краткое наименование: вместо devices.types.dishwasher можно использовать dishwasher, или вместо devices.types.thermostat.ac можно использовать thermostat.ac.

Обратите внимание

После изменения типа обязательно удалите устройство вручную в УДЯ и выполните Обновление списка устройств.

Пример

yandex_smart_home:
  entity_config:
    switch.dishwasher:
      name: Посудомойка
      type: dishwasher
    switch.gate:
      name: Ворота
      type: openable

Рекомендуемые альтернативные типы:

switch для светильников: Предотвращает включение по команде "Алиса, включи свет"
thermostat.ac: Кондиционер
cooking.kettle: Чайник

Сервис включения/выключения¶

Параметр: turn_on и turn_off

Переопределяет сервис, который будет вызван при включении или отключении устройства через УДЯ.

Параметр может быть использован, например, для выбора режима включения кондиционера.

Переопределение сервиса включения/выключения телевизора

yandex_smart_home:
  entity_config:
    media_player.tv:
      turn_on:
        service: script.tv_on
      turn_off:
        service: switch.turn_off
        entity_id: switch.tv_outlet

Для запрета включения или отключения устройства установите turn_on или turn_off равным false (без кавычек). Альтернативный способ повлиять на управление устройством - коды ошибок.

Запрет открытия замка из УДЯ (закрывать по-прежнему можно)

  yandex_smart_home:
    entity_config:
      lock.front_door:
        turn_on: false

Поддерживаемые функции (media_player)¶

Параметр: features (только для media_player)

Возможные значения: volume_mute, volume_set, next_previous_track, select_source¹, turn_on_off¹, play_pause¹, play_media¹ (список, можно все сразу)

Используется для явного указания поддерживаемых устройством функций. Необходим для устройств, которые меняют набор функций в зависимости от своего состояния (например Chrome Cast или Universal Mediaplayer).

Пример

yandex_smart_home:
  entity_config:
    media_player.chrome_cast:
      features:
        - volume_mute
        - volume_set
        - next_previous_track
        - select_source
        - turn_on_off
        - play_pause
        - play_media

Выбор каналов (media_player)¶

Параметр: support_set_channel (только для media_player)

Возможные значения: false

Отключает функцию выбора канала для media_player через цифровую панель и сервис media_player.play_media.

Может потребоваться для устройств, которые не поддерживают выбор канала, но поддерживают сервис play_media и переключение треков.

Пример

yandex_smart_home:
  entity_config:
    media_player.music_player:
      support_set_channel: false

Раздельные кнопки вкл/выкл¶

Параметр: state_unknown

Возможные значения: true

Включает раздельное отображение кнопок для включение и отключения устройства.

Рекомендуется использовать для устройств, которые не возвращают своё актуальное состояние (например шторы или вентилятор, управляемые по IR каналу).

Пример

yandex_smart_home:
  entity_config:
    cover.ir_shades:
      state_unknown: true

В версии 0.6.0 поддерживаются только домены cover и media_player.

Ограничение уровня громкости¶

Параметр: range

Ограничивает диапазон, в котором может регулироваться громкость устройства.

Пример

yandex_smart_home:
  entity_config:
    media_player.receiver:
      range:
        max: 95
        min: 20
        precision: 2  # шаг регулировки

Начиная с версии 0.6.1 ↩↩↩↩