skysilver
MajorDoMo и Яндекс Алиса. Общие сведения.
Часть 1. Об архитектуре платформы умного дома Яндекс и вариантах взаимодействия с MajorDoMo.
Оглавление
- Часть 1. Общие сведения.
- Часть 2. Публикация вебхуков.
- Часть 3. Регистрация приватного навыка.
- Часть 4. Объединение аккаунтов.
- Часть 5. Модуль Yandex Home.
- Часть 6. Алиса, включи свет на кухне.
- Часть 7. Алиса, сделай ярче настольную лампу.
- Часть 8. Алиса, измени цвет бра на красный.
- Часть 9. Алиса, включи канал Карусель.
Как известно, Яндекс запустил свою платформу умного дома с поддержкой голосового ассистента Алиса.
Платформа имеет открытое API и позволяет интегрировать Алису с оборудованием сторонних производителей и системами умного дома. На старте имеется поддержка Philips Hue, Redmond, SmartThings, Xiaomi, Rubetek.
Особенностью платформы является новая специальная категория навыков Алисы, которая предназначена для голосового управления домашними устройствами и не требует предварительного запуска навыка по его имени. Теперь устройствами можно управлять прямыми командами вида "Алиса, включи свет в гостиной", "Алиса, сделай в спальне похолоднее" и т. п.
Управление устройствами доступно как голосовыми командами, так и через веб-приложение по ссылке. Нативного приложения управления умным домом для iOS и Android у Яндекса нет.
Согласно официальной документации архитектура платформы умного дома Яндекс выглядит так.
Применительно к интеграции с MajorDoMo эту схему можно представить в таком виде.
Как видно из схемы, процедура взаимодействия пользователя с приложением и конечными устройствами умного дома выглядит следующим образом.
Пользователь открывает приложение Яндекс. Приложение отправляет запрос на получение информации об устройствах пользователя в облачную платформу Яндекс. Платформа направляет этот запрос к MajorDoMo. Далее приложение отправляет запрос на получение информации о статусах устройств пользователя. Платформа направляет этот запрос к MajorDoMo. В результате у пользователя на экране отображается список его устройств с актуальными статусами. Отправить актуальный статус устройства по факту его смены в облако Яндекс по инициативе MajorDoMo нельзя - это ограничение текущей версии API платформы.
Если пользователь хочет выключить лампочку, он выбирает ее в списке устройств и выключает с помощью виджета, либо произносит голосовую команду "Алиса, выключи лампочку". В это время приложение отправляет запрос на изменение статуса у устройства в облачую платформу. И от туда направляется запрос в MajorDoMo, который выключает лампочку.
Чтобы запустить навык умного дома и связать его с Яндекс, в общем случае требуется:
- Реализовать авторизационный сервис на основе стандарта OAuth 2.0.
- Реализовать Provider Adapter API. Это промежуточный API, который принимает на вход запросы в формате платформы умного дома Яндекса и преобразует их в запросы к API MajorDoMo.
- Описать устройства и их возможности в формате платформы умного дома Яндекса.
- Зарегистрировать навык специального типа в платформе Яндекс.Диалоги (публичный или приватный).
- Пройти модерацию и опубликивать навык. Публичный навык будет доступен всем пользователям, приватный - только пользователю, под чьей учетной записью он создавался.
В частных случаях, к примеру при размещении приватного навыка на своем домашнем сервере, возникают дополнительные требования:
- Белый публичный IP-адрес (статический или динамический).
- DNS-имя, привязанное к публичному IP-адресу.
- Валидный SSL-сертификат на вышеуказанное DNS-имя.
- Возможность опубликовать обработчик навыка (endpoint, webhook) для доступа к нему из сети Интернет.
По аналогии с Google Home интеграция MajorDoMo и платформы умного дома Яндекс возможна несколькими способами:
- Официальный публичный навык MajorDoMo, взаимодействующий с домашним сервером через синхронизацию с сервисом Connect (по подписке). На сегодняшний день еще не опубликован, но технически уже реализован и проходит процедуру модерации. В перспективе это будет самый простой (plug & play) способ, не требующий от пользователя каких-либо сложных подготовительных мероприятий.
- Не официальный публичный навык в виде MQTT-моста (или иного протокола). На сегодняшний день, разумеется, отсутствует, и не известно, появится ли вообще. Напрямую зависит от инициативы и активности сообщества.
- Приватный (частный) навык, напрямую взаимодействующий с облаком Яндекс без каких-либо посредников. Реализуется в виде модуля или набора скриптов в соответствии с API и предъявляет определенные требования к его запуску, которые не всегда могут быть выполнены (см. выше).
У каждого способа свои преимущества и недостатки. Какой выбрать - каждый решает сам. Лично мне интересен вариант приватного навыка, несмотря на его трудоемкость и требования, предъявляемые к запуску.
Мой проект по разработке модуля интеграции MajorDoMo и платформы умного дома Яндекс находится здесь.
Ссылки на официальные ресурсы:
- Промо-материалы
- Яндекс Помощь. Об умном доме Яндекса
- Платформа умного дома Яндекса
- API и документация разработчика
- Личный кабинет разработчика Яндекс.Диалоги
- Веб-приложение управления умным домом Яндекс
