Создание и настройки
Прочитайте концепцию управления умным домом. Чтобы создать навык, откройте консоль разработчика и нажмите . Откройте вкладку Настройки и заполните необходимые поля.
Основные настройки
Чтобы навык прошел модерацию, все настройки (название, описание, иконка и т. д.) должны отвечать формальным требованиям.
- Название
-
Название навыка, которое появится в каталоге.
Требования к названию:
- Состоит как минимум из двух слов без учета предлогов (рекомендуем использовать не более четырех слов). Допускается одно слово, если это уникальное название бренда.
- В каталоге нет такого же названия.
- Написано на русском или английском языке.
- Не ограничивается общей категорией товаров, сервисов или контента (например, «пластиковые окна»).
- Не содержит слов «Умный дом», «Алиса», «Яндекс» или «Станция».
- Backend
-
Параметры обработчика навыка, который будет принимать запросы пользователя через Яндекс Диалоги и отвечать на них.
Внимание.Время ожидания ответа от навыка — 3 секунды. Если платформа умного дома не получит ответ в течение этого времени, Алиса сообщит пользователю, что устройства долго не отвечают. При управлении через
пользователь увидит сообщение об ошибке и ID запроса.В 3 секунды входят:
- установка сетевого соединения;
- время доставки запроса до сервера навыка;
- собственное время работы навыка;
- время доставки ответа до серверов Алисы.
Внимание. Длина ответа не должна превышать 5000 символов, длина OAuth-токена и refresh-токена — 2048 символов. Время жизни токенов (свойствоexpires_in
) должно быть числом от 1 до 4 294 967 296. - Тип доступа
-
Доступ к опубликованному навыку бывает:
Публичный — навык попадет в каталог навыков, его увидят все пользователи Алисы.
Приватный — навык доступен только вам (на всех поверхностях, где вы авторизованы как создатель навыка).
Приватный навык не отправляется на модерацию, а сразу публикуется. Выдавайте к нему индивидуальный доступ пользователям Яндекса. Подробнее о приватных навыках читайте в разделе Доступ к навыку.
После публикации приватный навык появится в приложении Дом с Алисой. Откройте приложение Дом с Алисой, в правом верхнем углу нажмите и выберите Устройство умного дома. Вы найдете навык в списке популярных производителей.
Публикация в каталоге
- Подзаголовок
- Краткое описание навыка для списка навыков умного дома в приложении Дом с Алисой.
- Имя разработчика
- Имя автора навыка.
- Email разработчика
- Адрес для связи с разработчиком навыка (по умолчанию используется Яндекс Почта аккаунта, авторизованного в Диалогах).
- Официальный навык
-
Указание на то, что это официальный навык бренда, а разработчик — производитель устройств или его официальный представитель.
- Сайт для верификации прав использования бренда
-
Адрес сайта для навыка. Отобразится на странице описания навыка — в каталоге, в разделе Связь с разработчиком.
Если вы заполнили это поле, навык пройдет модерацию, когда вы подтвердите права на сайт в Яндекс Вебмастере.
Мы убедимся, что права на бренд принадлежат вам. Никто, кроме вас, не сможет использовать ваш бренд и официальный сайт для своего навыка.
- Описание
-
Описание функциональности навыка на русском языке, которое появится в каталоге. Перечислите типы устройств, с которыми работает навык, и дайте инструкции, как их подключить. Посмотрите пример описания навыка Aqara.
В описании доступны возможности языка разметки Markdown:
Заголовки:
# Первого уровня ## Второго уровня ### Третьего уровня
Цитаты:
> Текст, на который стоит > обратить внимание.
Списки:
* маркированный * список 1. нумерованный 2. список
- Заметки для модератора
-
Укажите информацию для тестирования:
- Тестовый аккаунт для проверки авторизации в навыке.
- Устройства, необходимые для работы навыка. Команда Диалогов запросит эти устройства у вас при проверке.
- Иконка
-
Изображение, которое появится в каталоге.
Требования к иконкам:
- Формат — PNG или JPG.
- Размер — 224 × 224 пикселя или больше. При необходимости изображение автоматически уменьшится.
- В иконке может использоваться название или логотип бренда, который указан в названии и описании навыка.
Поддерживаемые устройства
- ID или название товара
-
Перейдите на вкладку Устройства. Начните вводить название устройства и выберите его из выпадающего списка либо введите ID устройства из ссылки на Яндекс Маркете.
Ссылка на Яндекс Маркете:
https://market.yandex.ru/product--xiaomi-mi-led-smart-bulb/634589866
- ID устройства:
634589866
Пример ID устройства из ссылкиЭто поле необходимо заполнить, чтобы сертифицировать устройства при создании официальных навыков.
Часто задаваемые вопросы
- Установка сетевого соединения.
- Отправка запроса по сети с сервера Диалогов на сервер навыка.
- Формирование ответа.
- Отправка ответа по сети с сервера навыка на сервер Диалогов.
Время ожидания ответа от навыка — три секунды. Если Диалоги не получат ответ за три секунды, сессия завершится. Алиса сообщит пользователю, что навык не отвечает.
Да. Напишите в службу поддержки. Навык переместят в течение двух недель.
Чтобы не переносить брендированные навыки с личных аккаунтов сотрудников, создавайте такие навыки с корпоративных аккаунтов.
В три секунды входят: