Перейти к содержанию

Умения "Выбор из диапазона"

Управление параметрами устройства, которые имеют диапазон регулировки (громкость, яркость, температура). Настраиваются через словарь custom_ranges. В состоянии ожидается числовое значение.

Параметры

  • set_value: Действие выполняемое при установке абсолютного значения функции. В переменной value абсолютное или относительное значение (в зависимости от настроек range и наличия increase_value и decrease_value). Если не задано - установка абсолютного значения поддерживаться не будет.

    Пример

     set_value:
       action: xiaomi_miio_airpurifier.fan_set_favorite_speed
       entity_id: fan.xiaomi_airfresh_a1
       data:
         speed: '{{ value }}'
    
  • increase_value и decrease_value: Действия, вызываемые при относительной регулировке (кнопки + и - и "Алиса, убавь температуру"). Если не заданы - будет вызываться действие set_value.

  • range: Граничные значения диапазона. Для humidity, open, brightness есть ограничение: минимум 0, максимум 100. Если не задать min и max регулировка будет только относительная (в переменной value - 1 или -1).

    Пример

    range:
      # диапазон от -100 до 100
      min: -100
      max: 100
      # шаг изменения при нажатии на плюс или минус в интерфейсе, необязательное, по умолчанию - 1
      precision: 2
    

Для устройств, поддерживающих установку абсолютного значения, достаточно задать только set_value. А для устройств с поддержкой только относительного (например IR пульт) - increase_value и decrease_value.

Если ни одно действие не задано - умение из УДЯ управляться не будет.

Доступные функции

Функция Описание
brightness Изменение яркости световых элементов
channel Изменение канала, например телевизионного
humidity Изменение влажности
open Открывание чего-либо в процентах (открывание штор, окна)
temperature Изменение температуры (чайника, обогревателя)
volume Изменение громкости устройства
tea_mode Режима приготовления чая
thermostat Температурный режим работы климатической техники
work_speed Скорость работы

Примеры

Бризер

Изменение параметра favorit_speed на бризере Xiaomi (fan.xiaomi_airfresh_a1)

Атрибуты fan.xiaomi_airfresh_a1

model: dmaker.airfresh.a1
favorite_speed: 80

configuration.yaml

yandex_smart_home:
  entity_config:
    fan.xiaomi_airfresh_a1:
      custom_ranges:
        volume:  # как самое подходящее
          state_entity_id: fan.xiaomi_airfresh_a1
          state_attribute: favorit_speed
          set_value:
            action: xiaomi_miio_airpurifier.fan_set_favorite_speed
            data:
              speed: '{{ value }}'
          # значения для примера
          range:
            min: 60
            max: 300
            precision: 20 # по вкусу

Выбор канала

Выбор канала на телевизоре через media_player.play_media, листание каналов через отдельные скрипты, номер текущего канала нигде не хранится.

configuration.yaml

yandex_smart_home:
  entity_config:
    media_player.stupid_tv:
      custom_ranges:
        channel:
          set_value:
            action: media_player.play_media
            entity_id: media_player.stupid_tv
            data:
              media_content_type: channel
              media_content_id: '{{ value }}'
          increase_value:
            # действие отправит нажатие кнопки "канал вверх" по IR
            action: script.next_channel_via_ir
          decrease_value:
            # действие отправит нажатие кнопки "канал вниз" по IR
            action: script.prev_channel_via_ir
          range:
            min: 0
            max: 999