Версия ПО 1.33
В данном разделе описана процедура создания скиллов для голосового помощника VK «Маруся». После размещения приложения проходят модерацию, после чего добавляются в каталог SmartMarket.
Предварительная настройка
На вышестоящем сервере необходимо создать валидный 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
Платформа должна иметь публичный адрес в сети, а также иметь зарегистрированное доменное имя.
Создание приложения
Перейдите на страницу VK для разработчиков, выполните вход и нажмите Создать проект.
В проекте создайте приложение. Для этого нажмите Добавить приложение, задайте название и выберите тип. Нажмите Создать.
Созданное приложение отобразится на странице Приложения.
Выберите приложение и заполните необходимые параметры.
Задайте следующие значения:
- Название;
- Адрес API — https://домен:порт/api/v1/yandex/v1.0;
- Адрес страницы авторизации — https://домен:порт/api/v1/oauth2/authorize;
- Адрес для получения тоĸена — https://домен:порт/api/v1/oauth2/token;
- Адрес для обновления токена — https://домен:порт/api/v1/oauth2/token;
- Авторизационный client_id — <указать свой>;
- Авторизационный secret — <указать свой>;
- Протокол интеграции — Яндекс.
В конфигурационном файле /vars/default.yml задайте следующие параметры:
- client_id — <указать свой>;
- password — <указать свой>;
- App ID — ID приложения;
- oauthToken — можно запросить у техподдержки VK.
# Параметры проекта умного дома Mail.ru для интеграции с Марусей. Отображаются в карточке проекта/приложения marusyaSkill: # Параметры для Basic Authentication clientId: "MarusyaClientIdChangeMe" password: "PasswordChangeMe" # App ID, который был назначен приложению VK при создании appId: "MarusyaAppIdChangeMe" # OAuth-токен, который необходимо указывать при отправке уведомлений. oauthToken: ""
Повторно запустите ansible-playbook install_iot.yml