Умения

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

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

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

В зависимости от выполняемой операции в объекте Capability передается разный набор полей:
  1. Описание умения устройства используется в операции Информация об устройствах пользователя:
    {
        "type": {string},
        "retrievable": {boolean},
        "parameters": {CapabilityParameterObject}
    }          
  2. Статус умения устройства используется в операции Информация о состояниях устройств пользователя:
    {
        "type": {string},
        "state": {CapabilityParameterObject}
    }
  3. Команды для управления умением устройства используются в операции Изменение состояния у устройств:
    {
        "type": {string},
        "state": {CapabilityParameterObject}
    }

Типы умений

Тип умения Описание
on_off

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

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

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

range

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

toggle

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