Схема свойств сенсора Smart Home SensorState
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
, см. Intent performment .
Штаты | Тип | Описание |
---|---|---|
currentSensorStateData | Множество | Необходимый. Список текущих состояний датчиков. |
[ item, ... ] | Объект | Текущее состояние датчика. |
name | Нить | Необходимый. Имя состояния датчика. Соответствует значению из |
currentSensorState | Нить | Текущее описательное значение состояния. Соответствует значению из |
rawValue | Число | Текущее числовое значение датчика. |
alarmState | Нить | Состояние тревоги, соответствующее текущему показанию датчика. Предварительная тревога или тревога могут сработать, когда показания датчика приближаются и достигают опасных уровней. Поддерживаемые значения:
|
alarmSilenceState | Нить | Указывает на состояние отключения сигнала тревоги датчика, включая то, разрешено ли в данный момент отключение активного сигнала тревоги. Это состояние может быть предоставлено, когда активны состояние предварительной тревоги или тревоги. Для детектора дыма значения Поддерживаемые значения:
|
Более подробную информацию о различных возможностях и типах датчиков, поддерживаемых этой характеристикой, см. в разделе Поддерживаемые датчики .
Примеры
Сенсорное устройство, которое сообщает описательное значение состояния.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Сенсорное устройство, сообщающее числовое значение состояния.
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
Сенсорное устройство, сообщающее описательное и числовое значение состояния.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
Сенсорное устройство, которое сообщает описательное и числовое значение состояния и указывает на активный сигнал тревоги.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200, "alarmState": "ALARM" } ] }
Сенсорное устройство, которое сообщает описательное и числовое значение состояния и указывает на отключение сигнала тревоги.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200, "alarmState": "ALARM", "alarmSilenceState": "SILENCED" } ] }
КОМАНДЫ устройства
Никто.
УВЕДОМЛЕНИЯ устройства
Устройства с этой чертой могут возвращать следующую полезную нагрузку уведомления как часть изменения состояния устройства. Чтобы узнать больше о реализации уведомлений, см. Уведомления для действий умного дома .
Поля | Тип | Описание |
---|---|---|
SensorState | Объект | Необходимый. Полезная нагрузка уведомления. |
priority | Целое число | Необходимый. Представляет уровень уведомления. В настоящее время поддерживается значение 0, которое указывает на то, что уведомление должно быть произнесено вслух. |
name | Нить | Необходимый. Имя состояния датчика. См. список поддерживаемых типов датчиков для уведомлений. |
currentSensorState | Нить | Необходимый. Текущее описательное значение состояния. См. список поддерживаемых типов датчиков для уведомлений. |
Полезная нагрузка уведомления может содержать следующие типы датчиков:
-
AirQuality
-
CarbonMonoxideLevel
-
SmokeLevel
-
FilterCleanliness
-
WaterLeak
-
RainDetection
-
FilterLifeTime
Более подробную информацию о различных возможностях, поддерживаемых каждым типом датчика, см. в разделе Поддерживаемые датчики .
Примеры
The
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }