Обратная совместимость

Переход с 0.x на 1.x¶

Прямое подключение: настройки нотификатора¶

С версии 1.0 для прямого подключения служба уведомлений о состоянии устройств (нотификатор) настраивается через интерфейс (раздел Параметры навыка), а не YAML конфигурацию.

Параметры из секции notifier YAML конфигурации будут перенесены автоматически если в ней задан только один навык/пользователь.

Если у вас несколько записей в секции notifier (например задействованы несколько пользователей) – необходимо перенести параметры вручную. Для каждого пользователя/навыка потребуется создать отдельную интеграцию с прямым типом подключения.

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

С версии 1.0 при использовании прямого подключения для каждой пары навык-пользователь требуется создавать отдельную интеграцию. Если в вашем навыке авторизованы разные пользователи, или к вашему HA подключено несколько разных навыков, вы можете получить ошибку Failed to find Yandex Smart Home integration for request from yandex (user XXX).

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

Прямое подключение: поддержка Маруси¶

Если к вашему Home Assistant уже подключена Маруся, то при обновлении на v1.x она перестанет работать, а в журнале сервера появится ошибка Failed to find Yandex Smart Home integration for request from vk (user XXX)

Для её устранения вам нужно добавить новую интеграцию с типом подключения "Прямое" и платформой умного дома "Маруся". Список устройств для передачи можно скопировать с существующей интеграции.

После добавления интеграции Маруся заработает автоматически (удалять провайдера и добавлять повторно не требуется).

Состояние для custom_toggles¶

Пользовательские умения типа "Переключатели" теперь ожидают бинарные значения (on/off/yes/no/True/False/1/0) при определении своего состояния. До версии 1.0 умение считалось включенным, когда состояние отличалось от off.

До 1.0

yandex_smart_home:
  entity_config:
    humidifier.humidifier:
      custom_toggles:
        backlight:
          state_entity_id: select.humidifier_led_brightness  # значения high/med/off

После 1.0

yandex_smart_home:
  entity_config:
    humidifier.humidifier:
      custom_toggles:
        backlight:
          state_template: '{{ not is_state("select.humidifier_led_brightness", "off") }}'

Параметр pressure_unit¶

Параметр pressure_unit (раздел settings) больше не поддерживается, удалите его из YAML конфигурации.

Теперь компонент автоматически пытается сохранить единицы измерения при передаче значений датчиков из Home Assistant в УДЯ (подробнее о конвертации значений)

Клонирование интеграции¶

C версии 1.0 клонирование компонента не рекомендуется. Компонент теперь поддерживает добавление нескольких интеграций с разными фильтрами.

Прочие изменения¶

Прочие изменения в 1.0 не ломающие обратную совместимость с 0.x:

При настройке режимов в параметре entity_config.*.modes теперь рекомендуется использовать строки, а не списки. Использование списков допустимо, и менять это не планируется.
В настройках интеграции пункт меню "ID и Пароль (облачное подключение)" переименован в "Реквизиты для привязки".
Вызовы действий (сервисов) заменены c service: на action: (причина). Поддерживаются оба способа вызова, менять конфигурацию не требуется.

Откат на 0.x¶

Если вы обновились с 0.x до 1.x и что-то работает не правильно - откат обратно на 0.x возможен при выполнении нескольких условий:

Создана только одна запись интеграции Yandex Smart Home (страница Настройки → Устройства и службы → Интеграции → Yandex Smart Home)
В YAML конфигурации не используются новые для 1.x параметры
Способ выбор объектов для передачи в УДЯ не изменён на "Через ярлыки на объектах"

Для отката компонента скачайте последнюю версию 0.6.х через HACS.