О свойствах

Свойства (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