Об умениях

Умение (capability) — свойство объекта Устройство (device), которое описывает его возможности (умения). Устройство описывается как минимум одним умением, если у него при этом нет свойств. Платформа умного дома не ограничивает провайдеров в выборе возможностей для устройств, поэтому у пользователя могут появиться устройства с нестандартной связкой device_type:capability, например, у телевизора может быть функция «температура».

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

Совет

Проверить валидность параметров и увидеть соответствующие ошибки валидации можно с помощью раздела Тестирование в консоли разработчика.

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

В зависимости от выполняемой операции в объекте Capability передается разный набор полей:

  1. Описание умения устройства используется в операции Информация об устройствах пользователя:

    {
    "type": {string},
    "retrievable": {boolean},
    "reportable": {boolean},
    "parameters": {CapabilityParameterObject}
}

  2. Статус умения устройства используется в операциях Информация о состояниях устройств пользователя, Уведомление об изменении состояний устройств:

    {
    "type": {string},
    "state": {
        "instance": {string},
        "value": {InstanceValue}
    }
}

  3. Команды для управления умением устройства используются в операции Изменение состояния у устройств:

    {
    "type": {string},
    "state": {
        "instance": {string},
        "value": {InstanceValue}
    }
}

Типы умений

Тип умения

Описание

on_off

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

color_setting

Управление цветом для светящихся элементов в устройстве. Устройство может иметь одну или несколько из перечисленных функций:

  • изменение цвета своих светящихся элементов на произвольный из схемы HSV или из модели RGB;
  • изменение температуры цвета своих светящихся элементов;
  • воспроизведение различных визуальных эффектов.

mode

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

range

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

toggle

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

Предыдущая
washing_machine
Следующая
On_off