Схема признаков состояния датчика умного дома

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"
        ]
      }
    }
  ]
}

Поддерживаемые датчики

В следующих таблицах перечислены поддерживаемые типы датчиков и связанные с ними возможности.

Качество воздуха

Имя Описательные возможности Числовые возможности

Поддерживаемые значения:

AirQuality

Поддерживаемые значения:

healthy
moderate
unhealthy
unhealthy for sensitive groups
very unhealthy
hazardous
good
fair
poor
very poor
severe
unknown

Поддерживаемые значения:

AQI

Окись углерода

Имя Описательные возможности Числовые возможности

Поддерживаемые значения:

CarbonMonoxideLevel

Поддерживаемые значения:

carbon monoxide detected
high
no carbon monoxide detected
unknown

Поддерживаемые значения:

PARTS_PER_MILLION

Уровень дыма

Имя Описательные возможности Числовые возможности

Поддерживаемые значения:

SmokeLevel

Поддерживаемые значения:

smoke detected
high
no smoke detected
unknown

Поддерживаемые значения:

PARTS_PER_MILLION

Чистота фильтра

Имя Описательные возможности Числовые возможности

Поддерживаемые значения:

FilterCleanliness

Поддерживаемые значения:

clean
dirty
needs replacement
unknown
 Не поддерживается.

Утечка воды

Имя Описательные возможности Числовые возможности

Поддерживаемые значения:

WaterLeak

Поддерживаемые значения:

leak
no leak
unknown
 Не поддерживается.

Обнаружение дождя

Имя Описательные возможности Числовые возможности

Поддерживаемые значения:

RainDetection

Поддерживаемые значения:

rain detected
no rain detected
unknown
 Не поддерживается.

Срок службы фильтра

Имя Описательные возможности Числовые возможности

Поддерживаемые значения:

FilterLifeTime

Поддерживаемые значения:

new
good
replace soon
replace now
unknown

Поддерживаемые значения:

PERCENTAGE

Рассчитанный срок службы фильтра

Имя Описательные возможности Числовые возможности

Поддерживаемые значения:

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
 Не поддерживается.

Поддерживаемые значения:

PERCENTAGE

Уровень углекислого газа

Имя Описательные возможности Числовые возможности

Поддерживаемые значения:

CarbonDioxideLevel
 Не поддерживается.

Поддерживаемые значения:

PARTS_PER_MILLION

Твердые частицы

Имя Описательные возможности Числовые возможности

Поддерживаемые значения:

PM2.5
PM10
 Не поддерживается.

Поддерживаемые значения:

MICROGRAMS_PER_CUBIC_METER

Летучие органические соединения

Имя Описательные возможности Числовые возможности

Поддерживаемые значения:

VolatileOrganicCompounds
 Не поддерживается.

Поддерживаемые значения:

PARTS_PER_MILLION

СОСТОЯНИЯ устройства

Сущности с этим признаком могут сообщать о следующих состояниях как часть операции QUERY . Дополнительные сведения об обработке намерений QUERY см. в разделе Выполнение намерений .

Штаты Тип Описание
currentSensorStateData Множество

Необходимый.

Список текущих состояний датчика.

[ item, ... ] Объект

Текущее состояние датчика.

name Нить

Необходимый.

Название состояния датчика. Соответствует значению из sensorStatesSupported .

currentSensorState Нить

Текущее описательное значение состояния. Соответствует значению из sensorStatesSupported .

rawValue Число

Текущее числовое значение датчика.

alarmState Нить

Состояние тревоги, соответствующее текущим показаниям датчика. Предварительная или аварийная сигнализация может сработать, когда показания датчика приближаются и достигают опасного уровня.

Поддерживаемые значения:

IDLE
Будильник неактивен; обнаруженные уровни не опасны.
PRE_ALARM_1
Обнаруженные уровни повышены, но еще не достигли аварийного уровня; уровни могут вскоре стать опасными.
PRE_ALARM_2
Если устройство поддерживает несколько оповещений до достижения аварийных уровней, это указывает на более высокие уровни обнаружения, чем PRE_ALARM_1; уровни продолжают расти и вскоре могут приблизиться к аварийному уровню.
ALARM
Обнаруженные уровни достигли аварийного уровня, и сработала сигнализация.
alarmSilenceState Нить

Указывает состояние молчания сигнала тревоги датчика, в том числе разрешено ли в данный момент отключение звука активного сигнала тревоги. Это состояние может быть обеспечено, когда активно состояние предварительной тревоги или тревоги.

Поддерживаемые значения:

ALLOWED
Сигнал тревоги не отключен, и в настоящее время его отключение разрешено.
DISALLOWED
Звук сигнала тревоги не отключен, и его отключение в настоящее время не разрешено.
SILENCED
Тревога замолчала.

Дополнительные сведения о различных возможностях и типах датчиков, поддерживаемых этой функцией, см. в разделе «Поддерживаемые датчики» .

Примеры

Сенсорное устройство, сообщающее описательное значение состояния.

{
  "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",
      "alarmSilenceState": "DISALLOWED"
    }
  ]
}

КОМАНДЫ устройства

Никто.

УВЕДОМЛЕНИЯ УСТРОЙСТВА

Устройства с этой особенностью могут возвращать следующие полезные данные уведомления как часть изменения состояния устройства. Дополнительные сведения о реализации уведомлений см. в разделе «Уведомления для действий умного дома» .

Поля Тип Описание
SensorState Объект

Необходимый.

Полезная нагрузка уведомления.

priority Целое число

Необходимый.

Представляет уровень уведомлений. В настоящее время поддерживается значение 0, что означает, что уведомление должно быть произнесено вслух.

name Нить

Необходимый.

Название состояния датчика. См. список поддерживаемых типов датчиков для уведомлений.

currentSensorState Нить

Необходимый.

Текущее описательное значение состояния. См. список поддерживаемых типов датчиков для уведомлений.

Полезная нагрузка уведомления может содержать следующие типы датчиков:

  • AirQuality
  • CarbonMonoxideLevel
  • SmokeLevel
  • FilterCleanliness
  • WaterLeak
  • RainDetection
  • FilterLifeTime

Дополнительные сведения о различных возможностях, поддерживаемых каждым типом датчиков, см. в разделе «Поддерживаемые датчики» .

Примеры

обнаруживает дым.

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

ОШИБКИ устройства

Полный список ошибок и исключений смотрите .