Чеклист создания навыка

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

Чтобы создать навык умного дома:

Особенности навыков умного дома

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

• Связка аккаунтов. Для запуска навыков умного дома нужна связка аккаунтов. Чтобы навык мог управлять умными устройствами производителя, например устройствами Xiaomi, у навыка должен быть доступ к учетной записи пользователя в системе этого производителя. Так как Диалоги идентифицируют своих пользователей с помощью API Яндекс ID, для работы навыка необходимо связать аккаунт пользователя на Яндексе и аккаунт пользователя в системе производителя. Когда пользователь нажимает кнопку Привязать к Яндексу, он попадает на страницу авторизации. Подробнее см. раздел Как устроен процесс авторизации в навыке.

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

Официальные и неофициальные навыки

Навыки умного дома делятся на два типа:

• Официальные навыки — создаются и поддерживаются самими производителями умных устройств. Такие навыки помечаются в каталоге специальном значком . Устройства, которые работают с официальными навыками, показываются на Яндекс Маркете с бейджем Алисы. Вы можете помещать бейдж «Работает с Алисой» на маркетинговых материалах, упаковке и устройствах. Посмотрите в правилах дизайна, как использовать бейдж.
• Неофициальные навыки — создаются сторонними разработчиками или компаниями. Например, вы можете создать неофициальный навык, который позволяет управлять устройствами производителя Foo. Ваш навык будет отображаться в каталоге, но у него не будет специального значка. Яндекс Маркет будет показывать устройства, которые работают с такими навыками, без бейджа Алисы.

Чтобы навык был признан официальным:

1. При создании навыка установите атрибут Официальный навык.
2. В настройках навыка укажите свои официальные контакты: ваше имя, email и сайт вашей компании. Указанный сайт будет отображаться на странице описания навыка в каталоге, в разделе Информация. Обратите внимание: права на использование сайта должны быть подтверждены для вашего аккаунта в сервисе Яндекс Вебмастер.
3. При разработке навыка помните, что использование авторизации через Яндекс ID недопустимо для официального навыка.
4. Пройдите сертификацию устройств.

Когда ваш навык успешно пройдет модерацию, он будет установлен как официальный и может быть опубликован.

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

О платформе умного дома

Платформа умного дома Яндекса (далее — платформа умного дома) позволяет управлять умными устройствами различных производителей через:

• голосового помощника Алису;
• приложение Дом с Алисой.

С помощью платформы умного дома эти сервисы могут:

• получать информацию об устройствах пользователя;
• получать информацию о состоянии устройств пользователя;
• отправлять команды устройствам пользователя (например, команду «Включи лампочку»).

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

Полезные ссылки

• Порядок действий
• Что такое связка аккаунтов
• Спецификация OAuth 2.0
• Чат для обсуждения навыков умных устройств
• Чат-бот поддержки Яндекс Станции
• Сообщество разработчиков навыков Алисы

Часто задаваемые вопросы