Добро пожаловать в Центр разработчиков Google Home, новое место, где можно научиться разрабатывать действия для умного дома. Примечание. Вы продолжите создавать действия в консоли действий.
Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

Умный дом 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"
  }
}

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

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