Особенности интеграции и УДЯ
В компоненте Yandex Smart Home и Умном доме Яндекса существует ряд особенностей и ограничений, некоторые из них следует знать для максимально беспроблемной работы.
Принцип работы¶
Компонент создаёт в УДЯ устройства с набором умений (функций) и датчиков используя Объекты
(Entity
) из Home Assistant,
Устройства
(Devices
) Home Assistant никаким1 образом не используются.
Одно устройство в УДЯ может состоять из нескольких объектов Home Assistant, например, датчики.
В этой документации под словом "Устройство" подразумевается "Устройство в УДЯ, созданное из объектов Home Assistant"
Названия устройств¶
В названиях устройств возможны только русские символы и цифры, между словами и числами должны быть пробелы. Максимальная длина - 25 символов. Объекты не отвечающие данному требованию будут загружены в УДЯ как устройства, но потребуют ручного переименования.
Очень утомительно переименовывать устройств непосредственно в УДЯ, поэтому рекомендуется сразу задать правильные названия в Home Assistant.
Источники названия устройства (в порядке приоритета):
- Параметр
name
в параметрах устройства - Альтернативное название формата
Алиса: АБВ
(напримерАлиса: Лампочка
) вАльтернативных названиях
объекта:Настройки
→Устройства и службы
→Объекты
→Голосовые ассистенты
- Прочие альтернативные названия объекта, содержащие только кириллицу и цифры: должна быть включена опция
Учитывать альтернативные названия устройств и комнат
в настройках интеграции →Объекты передачи в УДЯ
(включена по умолчанию) Название объекта
на страницеНастройки
→Устройства и службы
→Объекты
- Атрибут
friendly_name
в customization.yaml - Параметр
alias
для скриптов
Комнаты¶
При добавлении нового устройства в УДЯ комната может назначаться автоматически, для этого она должна быть указана в Home Assistant.
К именам комнат предъявляются те же требования, что и к именам устройств (только русские символы и цифры).
Источники названия комнаты устройства (в порядке приоритета):
- Параметр
room
в параметрах устройства - Альтернативное название формата
Алиса: АБВ
(напримерАлиса: Кухня
) вАльтернативных названиях
пространства:Настройки
→Пространства и зоны
→ Пространство → Три точки →Настройки пространства
→Альтернативные названия
- Прочие альтернативные названия пространства, содержащие только кириллицу и цифры: должна быть включена опция
Учитывать альтернативные названия устройств и комнат
в настройках интеграции →Объекты передачи в УДЯ
(включена по умолчанию)
Для вариантов 2 и 3 в пространство должен быть включен объект напрямую, или устройство HA, в которое этот объект входит.
-
Устройства HA используются только для отображении модели в УДЯ и определения комнаты ↩