Версия ПО 1.35



|| DeviceType | Платформа |
|| DeviceName | ELIS |
|| DocTitleAdditional | Интеграция с умным домом Яндекс |
|| fwversion | 1.35 |



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

Предварительная настройка

На вышестоящем сервере необходимо создать валидный 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


Платформа должна иметь публичный адрес в сети, а также иметь зарегистрированное доменное имя.


Создание диалога

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

  1. Перейдите на страницу Яндекс.Диалоги (https://dialogs.yandex.ru/) и нажмите кнопку Создать навык. Далее авторизуйтесь на платформе Яндекс.
  2. На странице Яндекс.Диалоги нажмите кнопку Создать диалог.
  3. Выберите тип диалога Умный Дом. Откроется страница создания нового диалога.
  4. Во вкладке Связка аккаунтов заполните обязательные поля, а также поле URL для обновления токена (где Домен — адрес платформы ELIS):
Идентификатор приложения: (указать свой)
Секрет приложения: (указать свой)
URL авторизации: https://домен/api/v1/oauth2/authorize
URL для получения токена: https://домен/api/v1/oauth2/token
URL для обновления токена: https://домен/api/v1/oauth2/token


Идентификатор и секрет приложения указываются в конфигурационном файле default.yml в разделе skills:

yandex:
    enabled: true
    # Параметры для Basic Authentication.
    clientId: "YandexClientIdChangeMe"
    password: "PasswordChangeMe"

5. После сохранения настроек во вкладке Связка аккаунтов перейдите во вкладку Настройки. Заполните все обязательные поля и выставьте для параметра Тип доступа режим Приватный. В поле Backend введите адрес, на который будут отправляться запросы):

https://домен/api/v1/yandex

6. После сохранения настроек нажмите кнопку Опубликовать навык во вкладке Настройки и убедитесь, что под именем диалога статус изменился на «Диалог опубликован».

7. В файле /etc/ansible-iot-1.35/vars/default.yml в разделе skills.yandex укажите полученные после создания значения skillId и oauthToken.

8. Повторно запустите /etc/ansible-iot-1.35/install_iot.yml.

9. Протестируйте работу навыка.

Более подробное описание процедуры сопряжения учетной записи ELIS с УД Яндекс приведено в пользовательской документации Мобильное приложение Eltex Home.

Более подробное описание процедуры публикации навыка УД Яндекс доступно по ссылке:

https://yandex.ru/dev/dialogs/smart-home/doc/publishing.html