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

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 Число

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

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

Примеры

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

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

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

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