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

Alice-voice-control: различия между версиями

Материал из XIOT Wiki

Admin (обсуждение | вклад)

3 группы участника
3501 правка
ВизуальныйВики-текст
oldwiki>Admin
 
Английские адреса Wiki: обновление ссылок с сохранением русских подписей
 
(не показано 11 промежуточных версий этого же участника)
Строка 1: Строка 1:
__NOTOC__
{{DISPLAYTITLE:Голосовое управление через Алису}}
В текущем публично подтверждённом контуре интеграция XIOT позволяет добавить выбранные виртуальные устройства типа '''«Лампа»''' в приложение '''Дом с Алисой''' и управлять ими через интерфейс Яндекса или голосом.


= 🗣️ Добавление XIOT в Яндекс Станцию с Алисой =
'''Проверено 13 сентября 2026 года:''' публичная карточка навыка XIOT указывает класс устройств '''«Лампы»'''. Для виртуальной лампы XIOT сквозным тестом подтверждены включение, выключение и запрос текущего состояния. Другие типы устройств, отдельные характеристики и сценарии пока не считайте гарантированными возможностями интеграции, даже если они видны в редакторе.


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


== 📲 Как подключить XIOT к Алисе ==
Убедитесь, что:


1. Откройте приложение '''Дом с Алисой''' на смартфоне.
* XIOT-PLC привязан к нужному проекту. Для обнаружения лампы, запроса состояния и выполнения команд контроллер должен быть запущен и иметь доступ в интернет. Сама привязка аккаунта может завершиться и при временно недоступном контроллере, но это ещё не подтверждает работу управления;
* виртуальная лампа связана с физическим оборудованием и уже управляется из XIOT;
* адрес состояния лампы возвращает фактическое состояние, а не только отправленную команду;
* у лампы и комнаты короткие различимые названия;
* учётная запись XIOT имеет доступ к нужному проекту и его комнатам.


2. Нажмите кнопку '''+''' → '''Устройство умного дома'''.
Сначала устраните ошибки обычного управления в XIOT. Подключение Алисы не исправляет неверную привязку адресов управления и состояния.


3. Найдите в списке производителей платформу '''XIOT'''.
== Выбор устройств в XIOT-EDITOR ==


4. Нажмите '''Объединить аккаунты'''.
# Откройте нужный проект в XIOT-EDITOR.
# Откройте раздел '''Устройства''', затем вкладку '''Голосовое управление'''. Откроется окно '''Яндекс Алиса'''.
# Включите интеграцию.
# Оставьте включёнными только те лампы, которыми действительно нужно управлять через Яндекс. Если нужного объекта нет в списке совместимых устройств, не заменяйте его другим типом только ради отображения в Алисе.
# Нажмите '''Загрузить конфигурацию на контроллер'''. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.
# Дождитесь завершения загрузки и ещё раз проверьте выбранную лампу средствами XIOT.


5. В открывшемся окне введите логин и пароль от вашего аккаунта XIOT.
Изменение переключателя или списка устройств только в редакторе не меняет уже работающий XIOT-PLC: для применения нужна загрузка конфигурации.


6. Выберите нужный проект.
== Привязка аккаунта в приложении «Дом с Алисой» ==


7. Подтвердите подключение.
# Откройте на телефоне приложение '''Дом с Алисой'''.
# Нажмите '''+''', затем выберите '''Устройство умного дома'''.
# Найдите производителя '''XIOT'''.
# Нажмите '''Привязать к Яндексу''' или '''Объединить аккаунты''' — подпись зависит от версии приложения.
# На открывшейся странице XIOT введите логин и пароль учётной записи XIOT и нажмите '''Продолжить'''. Пароль проверяется XIOT и не передаётся Яндексу.
# Выберите один дом, то есть нужный проект XIOT, и нажмите '''Выбрать комнаты'''.
# Выберите хотя бы одну комнату. Алиса получит доступ только к активным совместимым устройствам выбранных комнат, которые одновременно доступны этой учётной записи XIOT.
# Нажмите '''Подключить к Алисе''', затем в приложении Яндекса выполните '''Обновить список устройств'''.
# Убедитесь, что ожидаемая лампа появилась в правильной комнате.


Повторная привязка позволяет изменить выбранный дом или набор доступных комнат. Выбирайте минимально необходимый набор комнат.


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


== ⚙️ Что должно быть настроено в XIOT ==
# Выберите известную лампу, включение которой не создаст опасной ситуации и не помешает людям.
# Сначала включите и выключите её из карточки устройства в приложении '''Дом с Алисой'''.
# Проверьте физическую реакцию лампы и фактическое состояние в XIOT.
# Затем повторите проверку голосом, используя точное имя устройства или комнаты.


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


== ✅ Что поддерживается Алисой ==
Текущее состояние запрашивается Яндексом у XIOT. Мгновенная отправка каждого изменения из XIOT в Алису для лампы не гарантируется, поэтому после управления лампой не через Алису отображение может обновиться с задержкой или при следующем запросе.


=== 💡 Освещение и розетки
== Что поддерживается ==
* Лампы — включение, яркость, цвет, температура цвета.
* Выключатели и розетки — вкл/выкл.


=== 🪟 Шторы и приводы
В текущем публично подтверждённом контуре поддерживается:
* Открытие, закрытие, позиционирование.


=== 🌡️ Климат
* виртуальное устройство XIOT '''«Лампа»''';
* Кондиционеры, радиаторы, тёплый пол, вентиляторы, бризеры — установка температуры, режимов, скорости.
* включение и выключение;
* Увлажнители — управление и влажность.
* запрос текущего состояния.


=== 📟 Сенсоры
Дополнительные возможности карточки лампы могут зависеть от активных характеристик и текущей версии интеграции. Проверяйте их фактически в приложении '''Дом с Алисой'''. Не используйте эту страницу как подтверждение поддержки розеток, выключателей, штор, климата, вентиляции, увлажнителей, датчиков, счётчиков или сценариев: для них нужна отдельная приёмка и обновление публичного перечня возможностей.
* Температура, влажность, освещённость, CO₂, качество воздуха.
* Датчики движения, открытия, протечки, дыма и давления.


=== 🔌 Электрика и вода
Актуальная публичная карточка интеграции: [https://dialogs.yandex.ru/store/skills/22a1089e-xiot навык XIOT в каталоге Яндекса]. Общий порядок подключения устройств стороннего производителя описан в [https://alice.yandex.ru/support/ru/smart-home/third-party/turn-on справке Яндекса].
* Клапаны и краны — открыть/закрыть.
* Счётчики воды и электроэнергии — отображение текущих показаний.


=== 🎬 Сценарии (управляются голосом)
== После изменения проекта ==
* Имитация рассвета
* Рабочий ритм
* Я дома / Я не дома
* Кинотеатр
* Выключить весь свет


== 🗣️ Примеры голосовых команд ==
После переименования лампы или комнаты, изменения привязки, состава устройств либо разрешения Алисы:


* «Алиса, включи свет в гостиной»
# загрузите новую конфигурацию на XIOT-PLC;
* «Алиса, активируй рассвет»
# в приложении '''Дом с Алисой''' откройте XIOT и нажмите '''Обновить список устройств''';
* «Алиса, я ушёл»
# повторите безопасную проверку включения, выключения и состояния.
* «Алиса, выключи отопление в ванной»
* «Алиса, закрой шторы»


== 📦 Обновление списка устройств ==
Если нужно изменить доступные Алисе комнаты, выполните привязку аккаунта повторно и выберите новый набор.


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


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


* новые устройства и сценарии;
* '''Отключить модуль на XIOT-PLC''' — выключите Яндекс Алису в XIOT-EDITOR и загрузите конфигурацию на контроллер.
* удалённые элементы;
* '''Отозвать связь аккаунтов''' — в приложении '''Дом с Алисой''' откройте список связанных производителей, выберите XIOT и выполните отвязку. При необходимости Яндекс предложит также удалить добавленные устройства.
* изменённые параметры (имена, характеристики).


Ручная синхронизация в приложении Яндекса не требуется.
Выключение модуля в проекте само по себе не следует считать отзывом выданного Яндексу доступа. Если доступ больше не нужен, отвяжите аккаунт отдельно. Порядок описан в [https://alice.yandex.ru/support/ru/smart-home/third-party/account-unlink справке Яндекса].


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


== 🔄 Обновление состояний устройств ==
{| class="wikitable"
! Симптом
! Что проверить
|-
| После входа нет нужного дома
| Использована ли правильная учётная запись XIOT и предоставлен ли ей доступ к проекту.
|-
| Нет нужной комнаты
| Есть ли комната в выбранном проекте и разрешён ли к ней доступ этой учётной записи XIOT.
|-
| Лампа не появилась
| Имеет ли объект тип '''«Лампа»''', включён ли он в разделе Яндекс Алисы, входит ли его комната в разрешённый набор, загружена ли текущая конфигурация и обновлён ли список устройств в приложении Яндекса.
|-
| Команда принята, но света нет
| Работает ли эта же команда в XIOT, корректны ли адрес управления и адрес состояния, находится ли XIOT-PLC в сети и реагирует ли физическое оборудование.
|-
| Показывается старое имя или удалённая лампа
| Загрузите актуальную конфигурацию, обновите список устройств. Если запись осталась, отвяжите и повторно привяжите XIOT, осознанно выбрав действие Яндекса с сохранением или удалением прежних устройств.
|-
| Отображаемое состояние отстаёт
| Запросите состояние повторно и сравните его с XIOT. Для лампы не обещается мгновенная инициативная отправка каждого изменения в Яндекс.
|}


Контроллер XIOT также передаёт текущее состояние устройств через `callback_state`:
Если причина остаётся неясной, приложите к обращению в [[Support|поддержку]] название проекта и комнаты, версию XIOT-PLC, время проверки, точное имя лампы, снимок экрана и результат проверки этой лампы в XIOT. Не отправляйте пароль, токены или другие данные доступа.


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


Эти данные обновляются в интерфейсе и используются для построения графиков в приложении «Дом с Алисой».
* Вводите логин и пароль только на странице авторизации XIOT, открытой из приложения Яндекса.
* Разрешайте только те комнаты, которыми действительно должна управлять Алиса.
* Для изменения набора комнат выполните повторную привязку.
* После передачи проекта или отзыва доступа проверьте связь аккаунтов и при необходимости отвяжите XIOT в приложении Яндекса.


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


== 🔐 Безопасность ==
* Обзор интеграционных модулей: [[Driver-setup|Настройка драйверов]].
* Проверка привязки оборудования: [[Device-bindings|Привязка реальных устройств к виртуальным]].
* Управление проектом без голоса: [[Xiot-app|Приложение для телефона и планшета XIOT-APP]].
* Диагностика с подготовкой данных: [[Support|Связь с поддержкой]].


* Только владелец проекта может активировать интеграцию.
[[Категория:XIOT-PLC]]
* Авторизация происходит через защищённый API XIOT.
[[Категория:Драйверы]]
* Связь можно разорвать в любой момент через приложение Яндекса
[[Категория:Интеграции]]
* Также можно отключить интеграцию с Яндекс в Редакторе в разделе голосовое управление, после отключения нужно загрузить конфигурацию на контроллер.
{{DEFAULTSORT:Голосовое управление через Алису}}
 
----
 
[[Категория:Интеграции XIOT]]
[[Категория:Голосовое управление]]
[[Категория:Яндекс Алиса]]

Текущая версия от 22:05, 2 октября 2026

В текущем публично подтверждённом контуре интеграция XIOT позволяет добавить выбранные виртуальные устройства типа «Лампа» в приложение Дом с Алисой и управлять ими через интерфейс Яндекса или голосом.

Проверено 13 сентября 2026 года: публичная карточка навыка XIOT указывает класс устройств «Лампы». Для виртуальной лампы XIOT сквозным тестом подтверждены включение, выключение и запрос текущего состояния. Другие типы устройств, отдельные характеристики и сценарии пока не считайте гарантированными возможностями интеграции, даже если они видны в редакторе.

Перед началом

Убедитесь, что:

  • XIOT-PLC привязан к нужному проекту. Для обнаружения лампы, запроса состояния и выполнения команд контроллер должен быть запущен и иметь доступ в интернет. Сама привязка аккаунта может завершиться и при временно недоступном контроллере, но это ещё не подтверждает работу управления;
  • виртуальная лампа связана с физическим оборудованием и уже управляется из XIOT;
  • адрес состояния лампы возвращает фактическое состояние, а не только отправленную команду;
  • у лампы и комнаты короткие различимые названия;
  • учётная запись XIOT имеет доступ к нужному проекту и его комнатам.

Сначала устраните ошибки обычного управления в XIOT. Подключение Алисы не исправляет неверную привязку адресов управления и состояния.

Выбор устройств в XIOT-EDITOR

  1. Откройте нужный проект в XIOT-EDITOR.
  2. Откройте раздел Устройства, затем вкладку Голосовое управление. Откроется окно Яндекс Алиса.
  3. Включите интеграцию.
  4. Оставьте включёнными только те лампы, которыми действительно нужно управлять через Яндекс. Если нужного объекта нет в списке совместимых устройств, не заменяйте его другим типом только ради отображения в Алисе.
  5. Нажмите Загрузить конфигурацию на контроллер. Команда сначала сохраняет проект локально и после успешной записи отправляет сохранённую конфигурацию на XIOT-PLC. Облачное сохранение и публикацию приложения проверяют отдельно: успешная загрузка на PLC их не подтверждает.
  6. Дождитесь завершения загрузки и ещё раз проверьте выбранную лампу средствами XIOT.

Изменение переключателя или списка устройств только в редакторе не меняет уже работающий XIOT-PLC: для применения нужна загрузка конфигурации.

Привязка аккаунта в приложении «Дом с Алисой»

  1. Откройте на телефоне приложение Дом с Алисой.
  2. Нажмите +, затем выберите Устройство умного дома.
  3. Найдите производителя XIOT.
  4. Нажмите Привязать к Яндексу или Объединить аккаунты — подпись зависит от версии приложения.
  5. На открывшейся странице XIOT введите логин и пароль учётной записи XIOT и нажмите Продолжить. Пароль проверяется XIOT и не передаётся Яндексу.
  6. Выберите один дом, то есть нужный проект XIOT, и нажмите Выбрать комнаты.
  7. Выберите хотя бы одну комнату. Алиса получит доступ только к активным совместимым устройствам выбранных комнат, которые одновременно доступны этой учётной записи XIOT.
  8. Нажмите Подключить к Алисе, затем в приложении Яндекса выполните Обновить список устройств.
  9. Убедитесь, что ожидаемая лампа появилась в правильной комнате.

Повторная привязка позволяет изменить выбранный дом или набор доступных комнат. Выбирайте минимально необходимый набор комнат.

Безопасная проверка

  1. Выберите известную лампу, включение которой не создаст опасной ситуации и не помешает людям.
  2. Сначала включите и выключите её из карточки устройства в приложении Дом с Алисой.
  3. Проверьте физическую реакцию лампы и фактическое состояние в XIOT.
  4. Затем повторите проверку голосом, используя точное имя устройства или комнаты.

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

Текущее состояние запрашивается Яндексом у XIOT. Мгновенная отправка каждого изменения из XIOT в Алису для лампы не гарантируется, поэтому после управления лампой не через Алису отображение может обновиться с задержкой или при следующем запросе.

Что поддерживается

В текущем публично подтверждённом контуре поддерживается:

  • виртуальное устройство XIOT «Лампа»;
  • включение и выключение;
  • запрос текущего состояния.

Дополнительные возможности карточки лампы могут зависеть от активных характеристик и текущей версии интеграции. Проверяйте их фактически в приложении Дом с Алисой. Не используйте эту страницу как подтверждение поддержки розеток, выключателей, штор, климата, вентиляции, увлажнителей, датчиков, счётчиков или сценариев: для них нужна отдельная приёмка и обновление публичного перечня возможностей.

Актуальная публичная карточка интеграции: навык XIOT в каталоге Яндекса. Общий порядок подключения устройств стороннего производителя описан в справке Яндекса.

После изменения проекта

После переименования лампы или комнаты, изменения привязки, состава устройств либо разрешения Алисы:

  1. загрузите новую конфигурацию на XIOT-PLC;
  2. в приложении Дом с Алисой откройте XIOT и нажмите Обновить список устройств;
  3. повторите безопасную проверку включения, выключения и состояния.

Если нужно изменить доступные Алисе комнаты, выполните привязку аккаунта повторно и выберите новый набор.

Отключение интеграции

Есть два разных действия:

  • Отключить модуль на XIOT-PLC — выключите Яндекс Алису в XIOT-EDITOR и загрузите конфигурацию на контроллер.
  • Отозвать связь аккаунтов — в приложении Дом с Алисой откройте список связанных производителей, выберите XIOT и выполните отвязку. При необходимости Яндекс предложит также удалить добавленные устройства.

Выключение модуля в проекте само по себе не следует считать отзывом выданного Яндексу доступа. Если доступ больше не нужен, отвяжите аккаунт отдельно. Порядок описан в справке Яндекса.

Если лампа не появилась или не управляется

Симптом Что проверить
После входа нет нужного дома Использована ли правильная учётная запись XIOT и предоставлен ли ей доступ к проекту.
Нет нужной комнаты Есть ли комната в выбранном проекте и разрешён ли к ней доступ этой учётной записи XIOT.
Лампа не появилась Имеет ли объект тип «Лампа», включён ли он в разделе Яндекс Алисы, входит ли его комната в разрешённый набор, загружена ли текущая конфигурация и обновлён ли список устройств в приложении Яндекса.
Команда принята, но света нет Работает ли эта же команда в XIOT, корректны ли адрес управления и адрес состояния, находится ли XIOT-PLC в сети и реагирует ли физическое оборудование.
Показывается старое имя или удалённая лампа Загрузите актуальную конфигурацию, обновите список устройств. Если запись осталась, отвяжите и повторно привяжите XIOT, осознанно выбрав действие Яндекса с сохранением или удалением прежних устройств.
Отображаемое состояние отстаёт Запросите состояние повторно и сравните его с XIOT. Для лампы не обещается мгновенная инициативная отправка каждого изменения в Яндекс.

Если причина остаётся неясной, приложите к обращению в поддержку название проекта и комнаты, версию XIOT-PLC, время проверки, точное имя лампы, снимок экрана и результат проверки этой лампы в XIOT. Не отправляйте пароль, токены или другие данные доступа.

Безопасность доступа

  • Вводите логин и пароль только на странице авторизации XIOT, открытой из приложения Яндекса.
  • Разрешайте только те комнаты, которыми действительно должна управлять Алиса.
  • Для изменения набора комнат выполните повторную привязку.
  • После передачи проекта или отзыва доступа проверьте связь аккаунтов и при необходимости отвяжите XIOT в приложении Яндекса.

Следующие шаги

Источник — https://wiki.xiot.ru/index.php?title=Alice-voice-control&oldid=5585