Об умениях

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

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

Совет.

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

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

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

Описание умения устройства используется в операции Информация об устройствах пользователя:
```
{
    "type": {string},
    "retrievable": {boolean},
    "reportable": {boolean},
    "parameters": {CapabilityParameterObject}
}          
```
Статус умения устройства используется в операциях Информация о состояниях устройств пользователя, Уведомление об изменении состояний устройств:
```
{
    "type": {string},
    "state": {
      "instance": {string},
      "value": {InstanceValue}
    }
}
```
Команды для управления умением устройства используются в операции Изменение состояния у устройств:
```
{
    "type": {string},
    "state": {
      "instance": {string},
      "value": {InstanceValue}
    }
}
```

Типы умений


Тип умения	Описание
`on_off`	Удаленное включение и выключение устройства (аналог нажатия кнопки питания на устройстве или его пульте управления). Является базовым умением для большинства устройств.
`color_setting`	Управление цветом для светящихся элементов в устройстве. Устройство может иметь одну или несколько из перечисленных функций: изменение цвета своих светящихся элементов на произвольный из схемы HSV или из модели RGB; изменение температуры цвета своих светящихся элементов; воспроизведение различных визуальных эффектов.
`mode`	Переключение режимов работы устройства, например, переключение между температурными режимами работы кондиционера: «Охлаждение», «Нагрев» или «Авто».
`range`	Управление параметрами устройства, которые имеют диапазон. Например, яркость лампы, громкость звука, температура обогревателя.
`toggle`	Управление параметрами устройства, которые могут находиться только в одном из двух состояний. Например, кнопки, тумблеры и подобные им элементы управления, которые включают или выключают какую-либо дополнительную функцию устройства.


Тип умения	Описание
`on_off`	Удаленное включение и выключение устройства (аналог нажатия кнопки питания на устройстве или его пульте управления). Является базовым умением для большинства устройств.
`color_setting`	Управление цветом для светящихся элементов в устройстве. Устройство может иметь одну или несколько из перечисленных функций: изменение цвета своих светящихся элементов на произвольный из схемы HSV или из модели RGB; изменение температуры цвета своих светящихся элементов; воспроизведение различных визуальных эффектов.
`mode`	Переключение режимов работы устройства, например, переключение между температурными режимами работы кондиционера: «Охлаждение», «Нагрев» или «Авто».
`range`	Управление параметрами устройства, которые имеют диапазон. Например, яркость лампы, громкость звука, температура обогревателя.
`toggle`	Управление параметрами устройства, которые могут находиться только в одном из двух состояний. Например, кнопки, тумблеры и подобные им элементы управления, которые включают или выключают какую-либо дополнительную функцию устройства.