Схема свойств сенсора 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"
        ]
      }
    }
  ]
}

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

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

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

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

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

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 , см. Intent performment .

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

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

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

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

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

name Нить

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

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

currentSensorState Нить

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

rawValue Число

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

alarmState Нить

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

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

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

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

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

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

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

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

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

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