Схема признаков состояния датчика умного дома
action.devices.traits.SensorState
— эта черта охватывает как количественные измерения, так и качественное состояние.
АТРИБУТЫ устройства
Устройства с этой характеристикой могут сообщать следующие атрибуты в рамках операции SYNC
. Дополнительные сведения об обработке намерений SYNC
см. в разделе Выполнение намерений .
Атрибуты | Тип | Описание |
---|---|---|
sensorStatesSupported | Множество | Необходимый. Каждый объект представляет возможности состояния датчика, поддерживаемые этим конкретным устройством. Каждый датчик должен иметь как минимум описательную или числовую функцию. Датчики также могут сообщать и то, и другое, и в этом случае числовое значение будет предпочтительным. |
[ item, ... ] | Объект | Поддерживаемые возможности датчика. Требуется минимум 1 предмет. |
name | Нить | Необходимый. Поддерживаемый тип датчика. См. таблицу «Поддерживаемые датчики». |
descriptiveCapabilities | Объект | Описание возможностей датчика. |
availableStates | Множество | Необходимый. Список доступных состояний устройства. Состояние «неизвестно» поддерживается неявно, когда датчик не возвращает значение. |
[ item, ... ] | Нить | Поддерживается описательное значение состояния. Требуется минимум 1 предмет. |
numericCapabilities | Объект | Описывает возможные числовые значения, которые может сообщить датчик. |
rawValueUnit | Нить | Необходимый. Поддерживаемая числовая единица. |
Дополнительные сведения о различных возможностях и типах датчиков, поддерживаемых этой функцией, см. в разделе «Поддерживаемые датчики».
Примеры
Сенсорное устройство, сообщающее описательное значение состояния.
{ "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ] }
Сенсорное устройство, которое сообщает числовое значение состояния.
{ "sensorStatesSupported": [ { "name": "CarbonMonoxideLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" } } ] }
Сенсорное устройство, которое сообщает описательное и числовое значение состояния.
{ "sensorStatesSupported": [ { "name": "SmokeLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" }, "descriptiveCapabilities": { "availableStates": [ "smoke detected", "high", "no smoke detected" ] } } ] }
Поддерживаемые датчики
В следующих таблицах перечислены поддерживаемые типы датчиков и связанные с ними возможности.
Качество воздуха
Имя | Описательные возможности | Числовые возможности |
---|---|---|
Поддерживаемые значения:
| Поддерживаемые значения:
| Поддерживаемые значения:
|
Окись углерода
Имя | Описательные возможности | Числовые возможности |
---|---|---|
Поддерживаемые значения:
| Поддерживаемые значения:
| Поддерживаемые значения:
|
Уровень дыма
Имя | Описательные возможности | Числовые возможности |
---|---|---|
Поддерживаемые значения:
| Поддерживаемые значения:
| Поддерживаемые значения:
|
Чистота фильтра
Имя | Описательные возможности | Числовые возможности |
---|---|---|
Поддерживаемые значения:
| Поддерживаемые значения:
| Не поддерживается. |
Утечка воды
Имя | Описательные возможности | Числовые возможности |
---|---|---|
Поддерживаемые значения:
| Поддерживаемые значения:
| Не поддерживается. |
Обнаружение дождя
Имя | Описательные возможности | Числовые возможности |
---|---|---|
Поддерживаемые значения:
| Поддерживаемые значения:
| Не поддерживается. |
Срок службы фильтра
Имя | Описательные возможности | Числовые возможности |
---|---|---|
Поддерживаемые значения:
| Поддерживаемые значения:
| Поддерживаемые значения:
|
Рассчитанный срок службы фильтра
Имя | Описательные возможности | Числовые возможности |
---|---|---|
Поддерживаемые значения:
| Не поддерживается. | Поддерживаемые значения:
|
Уровень углекислого газа
Имя | Описательные возможности | Числовые возможности |
---|---|---|
Поддерживаемые значения:
| Не поддерживается. | Поддерживаемые значения:
|
Твердые частицы
Имя | Описательные возможности | Числовые возможности |
---|---|---|
Поддерживаемые значения:
| Не поддерживается. | Поддерживаемые значения:
|
Летучие органические соединения
Имя | Описательные возможности | Числовые возможности |
---|---|---|
Поддерживаемые значения:
| Не поддерживается. | Поддерживаемые значения:
|
СОСТОЯНИЯ устройства
Сущности с этим признаком могут сообщать о следующих состояниях как часть операции QUERY
. Дополнительные сведения об обработке намерений QUERY
см. в разделе Выполнение намерений .
Штаты | Тип | Описание |
---|---|---|
currentSensorStateData | Множество | Необходимый. Список текущих состояний датчика. |
[ item, ... ] | Объект | Текущее состояние датчика. |
name | Нить | Необходимый. Название состояния датчика. Соответствует значению из |
currentSensorState | Нить | Текущее описательное значение состояния. Соответствует значению из |
rawValue | Число | Текущее числовое значение датчика. |
Дополнительные сведения о различных возможностях и типах датчиков, поддерживаемых этой функцией, см. в разделе «Поддерживаемые датчики».
Примеры
Сенсорное устройство, сообщающее описательное значение состояния.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Сенсорное устройство, которое сообщает числовое значение состояния.
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
Сенсорное устройство, которое сообщает описательное и числовое значение состояния.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
КОМАНДЫ устройства
Никто.
УВЕДОМЛЕНИЯ УСТРОЙСТВА
Устройства с этой особенностью могут возвращать следующие полезные данные уведомления как часть изменения состояния устройства. Дополнительные сведения о реализации уведомлений см. в разделе «Уведомления для действий умного дома» .
Поля | Тип | Описание |
---|---|---|
SensorState | Объект | Необходимый. Полезная нагрузка уведомления. |
priority | Целое число | Необходимый. Представляет уровень уведомлений. В настоящее время поддерживается значение 0, что означает, что уведомление должно быть произнесено вслух. |
name | Нить | Необходимый. Название состояния датчика. См. список поддерживаемых типов датчиков для уведомлений. |
currentSensorState | Нить | Необходимый. Текущее описательное значение состояния. См. список поддерживаемых типов датчиков для уведомлений. |
Полезная нагрузка уведомления может содержать следующие типы датчиков:
-
AirQuality
-
CarbonMonoxideLevel
-
SmokeLevel
-
FilterCleanliness
-
WaterLeak
-
RainDetection
-
FilterLifeTime
Дополнительные сведения о различных возможностях, поддерживаемых каждым типом датчиков, см. в разделе «Поддерживаемые датчики».
Примеры
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }