Alice-voice-control

🗣️ Добавление XIOT в Яндекс Станцию с Алисой

Интеграция XIOT с голосовым помощником Алиса позволяет управлять умным домом голосом — через Яндекс Станцию, приложение «Дом с Алисой» или любое другое устройство из экосистемы Яндекса.

📲 Как подключить XIOT к Алисе

1. Откройте приложение Дом с Алисой на смартфоне.

2. Нажмите кнопку + → Устройство умного дома.

3. Найдите в списке производителей платформу XIOT.

4. Нажмите Объединить аккаунты.

5. В открывшемся окне введите логин и пароль от вашего аккаунта XIOT.

6. Выберите нужный проект.

7. Подтвердите подключение.

После авторизации все подходящие устройства и сценарии отобразятся автоматически в приложении Яндекса.

⚙️ Что должно быть настроено в XIOT

• Добавьте в редакторе XIOT виртуальные устройства (например, лампы, розетки, кондиционеры).
• Свяжите их с физическим оборудованием.
• Убедитесь, что у устройств корректные имена на русском, и устройство включено в настройках голосового управления в редакторе.

✅ Что поддерживается Алисой

💡 Освещение и розетки

• Лампы — включение, яркость, цвет, температура цвета.
• Выключатели и розетки — вкл/выкл.

=== 🪟 Шторы и приводы

• Открытие, закрытие, позиционирование.

=== 🌡️ Климат

• Кондиционеры, радиаторы, тёплый пол, вентиляторы, бризеры — установка температуры, режимов, скорости.
• Увлажнители — управление и влажность.

=== 📟 Сенсоры

• Температура, влажность, освещённость, CO₂, качество воздуха.
• Датчики движения, открытия, протечки, дыма и давления.

=== 🔌 Электрика и вода

• Клапаны и краны — открыть/закрыть.
• Счётчики воды и электроэнергии — отображение текущих показаний.

=== 🎬 Сценарии (управляются голосом)

• Имитация рассвета
• Рабочий ритм
• Я дома / Я не дома
• Кинотеатр
• Выключить весь свет

🗣️ Примеры голосовых команд

• «Алиса, включи свет в гостиной»
• «Алиса, активируй рассвет»
• «Алиса, я ушёл»
• «Алиса, выключи отопление в ванной»
• «Алиса, закрой шторы»

📦 Обновление списка устройств

Список устройств и сценариев обновляется автоматически после загрузки проекта в контроллер XIOT-PLC.

Контроллер вызывает `callback_discovery` (см. [документацию](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference-alerts/post-skill_id-callback-discovery)) и передаёт:

• новые устройства и сценарии;
• удалённые элементы;
• изменённые параметры (имена, характеристики).

Ручная синхронизация в приложении Яндекса не требуется.

Если что-то не отображается:

• Убедитесь, что проект загружен в контроллер;
• Контроллер подключён к интернету;
• Аккаунт XIOT связан с Яндекс аккаунтом.

🔄 Обновление состояний устройств

Контроллер XIOT также передаёт текущее состояние устройств через `callback_state`:

• срабатывание датчиков;
• показания температуры, влажности, CO₂ и др.

Эти данные обновляются в интерфейсе и используются для построения графиков в приложении «Дом с Алисой».

Подробнее: [Документация callback_state](https://yandex.ru/dev/dialogs/smart-home/doc/ru/reference-alerts/post-skill_id-callback-state)

🔐 Безопасность

• Только владелец проекта может активировать интеграцию.
• Авторизация происходит через защищённый API XIOT.
• Связь можно разорвать в любой момент через приложение Яндекса
• Также можно отключить интеграцию с Яндекс в Редакторе в разделе голосовое управление, после отключения нужно загрузить конфигурацию на контроллер.

---