О свойствах

Свойства (properties) — свойства объекта Устройство (device) , которые описывают возможности. С помощью properties можно сообщать данные из свойств устройства. Свойства обычно используют для контроля за окружающей обстановкой. У устройства могут отсутствовать свойства.

Платформа умного дома не ограничивает провайдеров в выборе свойств для устройств, поэтому у пользователя могут появиться устройства с нестандартной связкой device_type:property, например, у телевизора может быть свойство «влажность».

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

Совет.

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

В зависимости от выполняемой операции в объекте Property передается разный набор полей:
  1. Описание свойства устройства используется в операции Информация об устройствах пользователя: 
    {
    "type": {string},
    "retrievable": {boolean},
    "reportable": {boolean},
    "parameters": {PropertyParametersObject}
}
  2. Статус свойства устройства используется в операции Информация о состояниях устройств пользователя: 
    {
    "type": {string},
    "state": {
      "instance": {string},
      "value": {InstanceValue}
    }
}

Типы свойств

Тип свойства Описание
float

Отображение значений свойств устройства в числовом формате.
event

Отображение показаний свойств устройства (свойства могут иметь одно из заданных состояний).
Тип свойства Описание
float

Отображение значений свойств устройства в числовом формате.
event

Отображение показаний свойств устройства (свойства могут иметь одно из заданных состояний).

Служба поддержки