О свойствах
Свойства (properties) — свойства объекта Устройство (device), которые описывают возможности. С помощью properties
можно сообщать данные из свойств устройства. Свойства обычно используют для контроля за окружающей обстановкой. У устройства могут отсутствовать свойства.
Платформа умного дома не ограничивает провайдеров в выборе свойств для устройств, поэтому у пользователя могут появиться устройства с нестандартной связкой device_type:property
, например, у телевизора может быть свойство «влажность».
В платформе умного дома есть определенный список поддерживаемых свойств. Если провайдер на запрос Информация об устройствах пользователя предоставит ответ с неизвестными свойствами, в неправильном формате или с невалидными значениями, то такое устройство будет отклонено, и пользователь не сможет им управлять.
Совет
Проверить валидность параметров и увидеть соответствующие ошибки валидации можно с помощью раздела Тестирование в консоли разработчика.
В зависимости от выполняемой операции в объекте Property передается разный набор полей:
-
Описание свойства устройства используется в операции Информация об устройствах пользователя:
{ "type": {string}, "retrievable": {boolean}, "reportable": {boolean}, "parameters": {PropertyParametersObject} }
-
Статус свойства устройства используется в операции Информация о состояниях устройств пользователя:
{ "type": {string}, "state": { "instance": {string}, "value": {InstanceValue} } }
Типы свойств
Тип свойства |
Описание |
Отображение значений свойств устройства в числовом формате. |
|
Отображение показаний свойств устройства (свойства могут иметь одно из заданных состояний). |