Версия ПО 1.23
В данном разделе описана процедура создания навыков для голосового помощника Алиса.
Предварительная настройка
На вышестоящем сервере необходимо создать валидный SSL-сертификат, например с помощью Let's Encrypt.
Для этого в настройках файла конфигурации Ansible ansible-iot/vars/default.yml укажите валидный e-mail в web_certbot_email):
web_enable_certbot: true web_certbot_email: test@email.com
После чего выполните повторную инициализацию конфигурации платформы:
ansible-playbook install.yml
Платформа должна иметь публичный адрес в сети, а также иметь зарегистрированное доменное имя.
Создание диалога
В качестве примера будет рассмотрено добавление тестового навыка (приватный) на платформу УД Яндекс. Такой навык не будет отображаться в списке доступных по умолчанию вендоров при добавлении через мобильное приложение УД Яндекс.
- Перейдите на страницу Яндекс.Диалоги (https://dialogs.yandex.ru/) и нажмите кнопку Создать навык. Далее авторизуйтесь на платформе Яндекс.
- На странице Яндекс.Диалоги нажмите кнопку Создать диалог.
- Выберите тип диалога Умный Дом. Откроется страница создания нового диалога.
- Во вкладке Связка аккаунтов заполните обязательные поля, а также поле URL для обновления токена (где Домен — адрес платформы Eltex SC):
Идентификатор приложения: (указать свой) Секрет приложения: (указать свой) URL авторизации: https://домен/api/v1/oauth2/authorize URL для получения токена: https://домен/api/v1/oauth2/token URL для обновления токена: https://домен/api/v1/oauth2/token
Идентификатор и секрет приложения указываются в конфигурационном файле default-for-docker.yml.j2 в разделе yandex-skill:
client-id: ""client-password: ""
5. После сохранения настроек во вкладке Связка аккаунтов перейдите во вкладку Настройки. Заполните все обязательные поля и выставьте для параметра Тип доступа режим Приватный. В поле Backend введите адрес, на который будут отправляться запросы):
https://домен/api/v1/yandex
6. После сохранения настроек нажмите кнопку Опубликовать навык во вкладке Настройки и убедитесь, что под именем диалога статус изменился на «Диалог опубликован».
7. Протестируйте работу навыка.
Более подробное описание процедуры сопряжения учетной записи Eltex SC с УД Яндекс приведено в пользовательской документации Мобильное приложение Eltex Home.
Более подробное описание процедуры публикации навыка УД Яндекс доступно по ссылке:
https://yandex.ru/dev/dialogs/smart-home/doc/publishing.html