Особенности интеграции и УДЯ

В компоненте Yandex Smart Home и Умном доме Яндекса существует ряд особенностей и ограничений, некоторые из них следует знать для максимально беспроблемной работы.

Принцип работы

Компонент создаёт в УДЯ устройства с набором умений (функций) и датчиков используя Объекты (Entity) из Home Assistant, Устройства (Devices) Home Assistant никаким¹ образом не используются.

Одно устройство в УДЯ может состоять из нескольких объектов Home Assistant, например, датчики.

В этой документации под словом "Устройство" подразумевается "Устройство в УДЯ, созданное из объектов Home Assistant"

Названия устройств

В названиях устройств возможны только русские символы и цифры, между словами и числами должны быть пробелы. Максимальная длина - 25 символов. Объекты не отвечающие данному требованию будут загружены в УДЯ как устройства, но потребуют ручного переименования.

Очень утомительно переименовывать устройств непосредственно в УДЯ, поэтому рекомендуется сразу задать правильные названия в Home Assistant.

Источники названия устройства (в порядке приоритета):

1. Параметр name в параметрах устройства
2. Альтернативное название формата Алиса: АБВ (например Алиса: Лампочка) в Альтернативных названиях объекта: Настройки → Устройства и службы → Объекты → Выбрать объект → → Голосовые ассистенты
3. Прочие альтернативные названия объекта, содержащие только кириллицу и цифры: должна быть включена опция Учитывать альтернативные названия устройств и комнат в настройках интеграции → Объекты передачи в УДЯ (включена по умолчанию)
4. Название объекта на странице Настройки → Устройства и службы → Объекты
5. Атрибут friendly_name в customization.yaml
6. Параметр alias для скриптов

Комнаты

При добавлении нового устройства в УДЯ комната может назначаться автоматически, для этого она должна быть указана в Home Assistant.

К именам комнат предъявляются те же требования, что и к именам устройств (только русские символы и цифры).

Источники названия комнаты устройства (в порядке приоритета):

1. Параметр room в параметрах устройства
2. Альтернативное название формата Алиса: АБВ (например Алиса: Кухня) в Альтернативных названиях пространства: Настройки → Пространства, зоны и ярлыки → Выбрать пространство → → Настройки пространства → Альтернативные названия
3. Прочие альтернативные названия пространства, содержащие только кириллицу и цифры: должна быть включена опция Учитывать альтернативные названия устройств и комнат в настройках интеграции → Объекты передачи в УДЯ (включена по умолчанию)

Для вариантов 2 и 3 в пространство должен быть включен объект напрямую, или устройство HA, в которое этот объект входит.

---

1. Устройства HA используются только для отображении модели в УДЯ и определения комнаты ↩