MajorDoMo

Модуль поддержки личных (приватных) навыков для платформы умного дома Яндекс.

Платформа умного дома Яндекс имеет открытое API и позволяет интегрировать Яндекс Алису с оборудованием сторонних производителей и системами умного дома. На старте имеется поддержка Philips Hue, Redmond, SmartThings, Xiaomi, Rubetek. Модуль Yandex Home, в свою очередь, реализует приватный API-провайдер (включая авторизацию по протоколу OAuth 2.0) и позволяет интегрировать с платформой Яндекс уже имеющиеся в MajorDoMo устройства.

Особенностью платформы умного дома Яндекс является новая специальная категория навыков Алисы, которая предназначена для голосового управления домашними устройствами и не требует предварительного запуска навыка по его имени. Теперь устройствами можно управлять прямыми командами вида "Алиса, включи свет в гостиной", "Алиса, сделай в спальне похолоднее" и т. п. При этом следует понимать, что в отличие от классических навыков, Яндекс не передает в MajorDoMo распознанный текст команды пользователя, а передается непосредственно управляющая команда для устройства, которая интерпретируется модулем и записывается в привязанное свойство объекта.

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

Поддерживаемые умения:

• Включить/выключить (on);
• Громкость (volume);
• ТВ-канал (channel);
• Температура (temperature);
• Температура цвета (temperature_k);
• Температурный режим (thermostat);
• Режим без звука (mute);
• Скорость вентиляции (fan_speed);
• Цвет в формате RGB (rgb);
• Яркость (brightness).

Требования:

1. Белый публичный IP-адрес (статический или динамический).
2. DNS-имя, привязанное к публичному IP-адресу.
3. Валидный SSL-сертификат на вышеуказанное DNS-имя.
4. Возможность опубликовать обработчик навыка (endpoint, webhook) для доступа к нему из сети Интернет без запроса логина и пароля.

Кроме того, для работы с базой данных требуется активное PHP-расширение pdo_mysql (подробнее здесь).

Важно! Если в MajorDoMo используется базовая авторизация, то все вебхуки необходимо добавить в исключения авторизации. Подробнее см. здесь.

Модуль на Github - https://github.com/skysilver-lab/majordomo-yandexhome
Модуль в Connect - https://connect.smartliving.ru/tasks/482.html
Поддержать разработку, развитие модуля и добавление новых умений:

• Yandex: 410011205062626
• PayPal: paypal.me/skysilver
• Внутренний счет в Connect
• и другие способы по договоренности (Сбербанк, Тинькофф).

С уважением, skysilver.

Документация по модулю

• MajorDoMo и Яндекс Алиса. Общие сведения.
• MajorDoMo и Яндекс Алиса. Публикация вебхуков.
• MajorDoMo и Яндекс Алиса. Регистрация приватного навыка.
• MajorDoMo и Яндекс Алиса. Объединение аккаунтов.
• MajorDoMo и Яндекс Алиса. Модуль Yandex Home.
• MajorDoMo и Яндекс Алиса. Алиса, включи свет на кухне.
• MajorDoMo и Яндекс Алиса. Алиса, сделай ярче настольную лампу.
• MajorDoMo и Яндекс Алиса. Алиса, измени цвет бра на красный.
• MajorDoMo и Яндекс Алиса. Алиса, включи канал Карусель.

Ссылки на полезные материалы

• Загрузка PHP-расширения PDO MySQL в Windows
• Добавление вебхуков в исключения авторизации MajorDoMo

Как задавать вопрос

В случае обнаружении багов (проблем) в работе модуля включите ведение логов в настройках модуля, воспроизведите проблему повторно и приложите полученные логи с детальным пошаговым описанием ситуации (включая скриншоты) к своему сообщению на форуме. Также укажите сведения о сервере MajorDoMo и способе публикации вебхуков. Вопросы без подробной исходной информации в большинстве случаев будут игнорироваться.

Известные проблемы и ограничения

• Не синхронизируется список устройств в приложении Яндекс Quasar.
  РешениеПоказать

  1. Вебхуки требуют ввода логина и пароля при доступе к ним не из домашней сети. Необходимо проверить это, открыв адреса вебхуков в браузере через мобильный интернет, либо через прокси и т.п. Если логин/пароль запрашивается, то нужно добавить вебхуки в исключения авторизации MajorDoMo. Подробнее см. здесь.
  2. Невалидный SSL-сертификат (истек срок действия, выпущен не на тот домен, либо вообще отсутствует). Необходимо сгенерировать и установить корректный SSL-сертификат и проверить доступность вебхуков из вне по протоколу HTTPS.
  3. Истек срок действия токена доступа. Необходимо отвязать аккаунт вашего приватного навыка в приложении Яндекс и затем повторно объединить аккаунты.
  4. Некорректная настройка веб-сервера Nginx (актуально для образа Raspberry Pi от 9.07.19). Необходимо в файл /etc/nginx/fastcgi_params добавить строку fastcgi_param PATH_INFO $fastcgi_path_info; и перезапустить Nginx.
• Не удаляются устройства из приложения Яндекс Quasar.
  РешениеПоказать

  В настройках приложения Яндекс Quasar удалить комнату(ы), к которым привязаны устройства. После этого такие устройства перейдут в состояние "требуется настройка", и их можно будет удалить.

Всем причастным спасибо за донаты. Публикация модуля запланирована на следующую неделю.

А зачем нужен PDO ?

Aven писал(а): ↑

Пн июн 10, 2019 1:13 pm

А зачем нужен PDO ?

Не стал с нуля писать поддержку OAuth2. Использовал готовую библиотеку, а в ней хранилище токенов в MySQL через PDO реализовано.

skysilver писал(а): ↑

Пн июн 10, 2019 1:17 pm

Использовал готовую библиотеку, а в ней хранилище токенов в MySQL через PDO реализовано.

Эту брали? https://github.com/bshaffer/oauth2-server-php

dmw писал(а): ↑

Пн июн 10, 2019 1:45 pm

Эту брали? https://github.com/bshaffer/oauth2-server-php

Да, она самая.

MajorDoMo и Яндекс Алиса. Модуль Yandex Home.

Часть 5. О модуле Yandex Home.

Читать статью в блоге

skysilver писал(а): ↑

Пн июн 10, 2019 1:17 pm

Aven писал(а): ↑

Пн июн 10, 2019 1:13 pm

А зачем нужен PDO ?

Не стал с нуля писать поддержку OAuth2. Использовал готовую библиотеку, а в ней хранилище токенов в MySQL через PDO реализовано.

Понятно, я велосипед написал, хотя там малая часть возможностей OAuth2 нужна... ))