Начало работы

Навыки умного дома — специальная категория навыков Алисы, предназначенных для голосового управления домашними устройствами. Например, пользователь может попросить Алису включить чайник, установить нужную температуру в обогревателе, выключить свет в детской или сделать телевизор потише.

Чтобы создать нужный навык:

  • Откройте консоль разработчика, нажмите Создать диалог, затем Умный дом. Руководство по заполнению полей приведено ниже.
  • Реализуйте взаимодействие с Яндекс.Диалогами по протоколу OAuth 2.0, чтобы пользователь мог авторизовать навык в системе управления умным домом.
  1. Основные настройки
  2. Публикация в каталоге
  3. Связка аккаунтов

Основные настройки

Название

Название навыка, которые будет отображаться в каталоге.

Название должно:

  • Состоять не менее чем из 2 слов без учета предлогов (рекомендуется использовать не более 4 слов). Допускается название из 1 слова, если это уникальное название бренда.
  • Быть уникальным в каталоге.
  • Быть написанным на русском или английском языке.
  • Не ограничиваться общей категорией товаров, сервисов или контента (например, «пластиковые окна»).
  • Не содержать слов «Умный дом», «Алиса», «Яндекс» или «Станция».
  • Отвечать остальным формальным требованиям.
Endpoint URL

Адрес обработчика навыка, который будет принимать запросы Яндекс.Диалогов к умному дому и отвечать на них. Обработчик обязательно должен работать по HTTPS, протокол должен быть указан в адресе, например https://example.com/smart-home/.

Примечание. Время ожидания ответа от навыка — 3 секунды. Если Диалоги не получат ответ в течение этого времени, сессия навыка завершится. Алиса сообщит пользователю, что навык не отвечает.

Публикация в каталоге

Приватность

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

Примечание. Приватным навыком умного дома может воспользоваться только его разработчик.
Подзаголовок
Краткое описание навыка для списка навыков умного дома в приложении Яндекс.
Имя разработчика
Имя автора навыка, которое следует отображать в каталоге.
E-mail разработчика
Адрес для связи с разработчиком навыка (по умолчанию используется Яндекс.Почта аккаунта, авторизованного в Диалогах).
Сайт для верификации прав использования бренда

Адрес сайта для навыка. Навык, для которого вы заполнили это поле, пройдет модерацию только если вы подтвердили права на указанный сайт в Яндекс.Вебмастере.

Права на сайт проверяются с помощью Вебмастера, чтобы навык с вашим брендом могли опубликовать только вы. Если бы этой проверки не было, кто угодно мог бы использовать ваш бренд и официальный сайт для своего навыка — Яндекс.Диалоги не могли бы автоматически убедиться в том, что права на бренд принадлежат вам, а не кому-то еще.

Описание

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

Пример описания навыка
# О навыке ExampleAppliances

Навык ExampleAppliances позволяет управлять умной техникой в доме. 
Используя голосовые команды, вы сможете включить чайник или изменить
скорость работы вентилятора. Управлять устройствами можно не только
голосом, но и кнопками со смартфона.

Обратите внимание, что для голосового управления необходим центр
умного дома MyExampleAppliancesHub.

Как настроить навык:
1. Скачайте приложение ExampleAppliances. Оно работает на Android и iOS.
2. Зарегистрируйтесь в приложении.
3. Подключите центр умного дома MyExampleAppliancesHub.
4. Укажите устройства, которыми будете управлять.
5. ...

Какими устройствами вы сможете управлять:
* Телевизор Baboo модели XXX;
* Все чайники марки Foo;
* Робот-пылесос Zumba.

Чтобы оформить описание, можно использовать некоторые возможности языка разметки Markdown:

  • Заголовки:

    # Первого уровня
    ## Второго уровня
    ### Третьего уровня
  • Цитаты:

    > Текст, на который стоит
    > обратить внимание.
  • Списки:

    * маркированный
    * список
    
    1. нумерованный
    2. список

Чтобы навык прошел модерацию, описание должно отвечать формальным требованиям.

Заметки для модератора

В этом поле нужно указать необходимую для тестирования информацию:

  • Тестовый аккаунт для проверки авторизации в навыке.
  • Если для работы навыка необходимы определенные устройства, опишите их, и команда Диалогов запросит эти устройства у вас при проверке.

Иконка

Изображение размером 224×224 пикселя, которое отображается в каталоге. Рекомендуется загружать картинки этого или большего размера. При необходимости изображение будет автоматически уменьшено.

Ограничения для иконок:

  • Поддерживаемые форматы — PNG и JPG.
  • В иконке может использоваться название или логотип только того бренда, который указан в названии, активационном имени и описании навыка.
  • Чтобы навык прошел модерацию, иконка должна отвечать формальным требованиям.

Связка аккаунтов

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