Умный дом SensorState Trait Scheme

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

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

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