Об умениях

Умение (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

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

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