Версия ПО 1.26

|| DeviceType | Платформа |
|| DeviceName | Eltex SC |
|| DocTitleAdditional | Интеграция с умным домом VK |
|| fwversion | 1.26 |

В данном разделе описана процедура создания скиллов для голосового помощника 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 для разработчиков, выполните вход и нажмите Создать проект.

Eltex Documentation > Интеграция с умным домом VK v1.26 > Снимок экрана от 2023-03-14 13-40-40.png

В проекте создайте приложение. Для этого нажмите Добавить приложение, задайте название и выберите тип. Нажмите Создать.

Eltex Documentation > Интеграция с умным домом VK v1.26 > Снимок экрана от 2023-03-14 13-42-22.png

Eltex Documentation > Интеграция с умным домом VK v1.26 > Снимок экрана от 2023-03-14 13-43-36.png

Созданное приложение отобразится на странице Приложения.

Eltex Documentation > Интеграция с умным домом VK v1.26 > Снимок экрана от 2023-03-14 13-44-59.png

Выберите приложение и заполните необходимые параметры.

Eltex Documentation > Интеграция с умным домом VK v1.26 > Снимок экрана от 2023-03-14 13-50-38.png

Задайте следующие значения:

Название;
Адрес 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