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

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

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

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