Версия ПО 1.33
В данном разделе описана процедура создания навыков для голосового помощника Алиса. После размещения навыки проходят модерацию, после чего добавляются в каталог Яндекс.
Предварительная настройка
На вышестоящем сервере необходимо создать валидный SSL-сертификат, например с помощью Let's Encrypt.
Для этого в настройках файла конфигурации Ansible ansible-iot/vars/default.yml укажите валидный e-mail в email
:
certbot: # Использовать ли certbot для получения сертификатов Let's Encrypt enable: false # E-mail владельца домена. Необходим для подтверждения валидности домена при получении сертификата Let's Encrypt email: test@email.com
После чего выполните повторную инициализацию конфигурации платформы:
ansible-playbook install_iot.yml
Платформа должна иметь публичный адрес в сети, а также иметь зарегистрированное доменное имя.
Создание диалога
В качестве примера будет рассмотрено добавление тестового навыка (приватный) на платформу УД Яндекс. Такой навык не будет отображаться в списке доступных по умолчанию вендоров при добавлении через мобильное приложение УД Яндекс.
- Перейдите на страницу Яндекс.Диалоги (https://dialogs.yandex.ru/) и нажмите кнопку Создать навык. Далее авторизуйтесь на платформе Яндекс.
- На странице Яндекс.Диалоги нажмите кнопку Создать диалог.
- Выберите тип диалога Умный Дом. Откроется страница создания нового диалога.
- Во вкладке Связка аккаунтов заполните обязательные поля, а также поле URL для обновления токена (где Домен — адрес платформы ELIS):
Идентификатор приложения: (указать свой) Секрет приложения: (указать свой) URL авторизации: https://домен/api/v1/oauth2/authorize URL для получения токена: https://домен/api/v1/oauth2/token URL для обновления токена: https://домен/api/v1/oauth2/token
Идентификатор и секрет приложения указываются в конфигурационном файле default.yml в разделе yandex-skill:
yandexSkill:
# Параметры для Basic Authentication.
clientId: "YandexClientIdChangeMe"
password: "PasswordChangeMe"
5. После сохранения настроек во вкладке Связка аккаунтов перейдите во вкладку Настройки. Заполните все обязательные поля и выставьте для параметра Тип доступа режим Приватный. В поле Backend введите адрес, на который будут отправляться запросы):
https://домен/api/v1/yandex
6. После сохранения настроек нажмите кнопку Опубликовать навык во вкладке Настройки и убедитесь, что под именем диалога статус изменился на «Диалог опубликован».
7. В файле /etc/ansible-iot-1.33/vars/default.yml в разделе yandex-skill укажите полученные после создания данные skill-id и oauth-token.
8. Повторно запустите /etc/ansible-iot-1.33/install_iot.yml.
9. Протестируйте работу навыка.
Более подробное описание процедуры сопряжения учетной записи ELIS с УД Яндекс приведено в пользовательской документации Мобильное приложение Eltex Home.
Более подробное описание процедуры публикации навыка УД Яндекс доступно по ссылке:
https://yandex.ru/dev/dialogs/smart-home/doc/publishing.html