Esquema de atributos SensorState de la casa inteligente

action.devices.traits.SensorState: Este atributo abarca la medición cuantitativa y el estado cualitativo.

ATRIBUTOS del dispositivo

Los dispositivos con esta característica pueden informar los siguientes atributos como parte de la operación SYNC. Para obtener más información sobre cómo controlar intents SYNC, consulta Cómo entregar intents.

Atributos Tipo Descripción
sensorStatesSupported Matriz

Obligatorio.

Cada objeto representa las capacidades de estado del sensor que admite este dispositivo específico. Cada sensor debe tener al menos una capacidad descriptiva o numérica. Los sensores también pueden informar ambos, en cuyo caso se preferirá el valor numérico.
[item, ...] Objeto

Funciones de sensores compatibles

Se requiere al menos 1 elemento.
name String

Obligatorio.

Tipo de sensor admitido. Consulta la tabla Sensores compatibles.
descriptiveCapabilities Objeto

Es una descripción de las capacidades del sensor.
availableStates Matriz

Obligatorio.

Es la lista de los estados disponibles para el dispositivo. El estado "desconocido" se admite de forma implícita cuando el sensor no muestra un valor.
[item, ...] String

Valor de estado descriptivo admitido.

Se requiere al menos 1 elemento.
numericCapabilities Objeto

Describe los posibles valores numéricos que puede informar el sensor.
rawValueUnit String

Obligatorio.

Unidad numérica admitida.

Consulta Sensores compatibles para obtener más detalles sobre las diferentes capacidades y tipos de sensores que admite esta función.

Ejemplos

Dispositivo sensor que informa el valor de estado descriptivo.

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

Dispositivo de sensor que informa un valor de estado numérico.

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

Dispositivo de sensor que informa un valor de estado descriptivo y numérico.

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

Sensores compatibles

En las siguientes tablas, se enumeran los tipos de sensores admitidos y sus capacidades asociadas.

Calidad del aire

Nombre Capacidades descriptivas Funciones numéricas

Valores admitidos:

AirQuality

Valores admitidos:

healthy
moderate
unhealthy
unhealthy for sensitive groups
very unhealthy
hazardous
good
fair
poor
very poor
severe
unknown

Valores admitidos:

AQI

Monóxido de carbono

Nombre Capacidades descriptivas Funciones numéricas

Valores admitidos:

CarbonMonoxideLevel

Valores admitidos:

carbon monoxide detected
high
no carbon monoxide detected
unknown

Valores admitidos:

PARTS_PER_MILLION

Nivel de humo

Nombre Capacidades descriptivas Funciones numéricas

Valores admitidos:

SmokeLevel

Valores admitidos:

smoke detected
high
no smoke detected
unknown

Valores admitidos:

PARTS_PER_MILLION

Estado del filtro

Nombre Capacidades descriptivas Funciones numéricas

Valores admitidos:

FilterCleanliness

Valores admitidos:

clean
dirty
needs replacement
unknown
 No compatible.

Fuga de agua

Nombre Capacidades descriptivas Funciones numéricas

Valores admitidos:

WaterLeak

Valores admitidos:

leak
no leak
unknown
 No compatible.

Detección de lluvia

Nombre Capacidades descriptivas Funciones numéricas

Valores admitidos:

RainDetection

Valores admitidos:

rain detected
no rain detected
unknown
 No compatible.

Vida útil del filtro

Nombre Capacidades descriptivas Funciones numéricas

Valores admitidos:

FilterLifeTime

Valores admitidos:

new
good
replace soon
replace now
unknown

Valores admitidos:

PERCENTAGE

Vida útil del filtro calculada

Nombre Capacidades descriptivas Funciones numéricas

Valores admitidos:

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
 No compatible.

Valores admitidos:

PERCENTAGE

Nivel de dióxido de carbono

Nombre Capacidades descriptivas Funciones numéricas

Valores admitidos:

CarbonDioxideLevel
 No compatible.

Valores admitidos:

PARTS_PER_MILLION

Material particulado

Nombre Capacidades descriptivas Funciones numéricas

Valores admitidos:

PM2.5
PM10
 No compatible.

Valores admitidos:

MICROGRAMS_PER_CUBIC_METER

Compuestos orgánicos volátiles

Nombre Capacidades descriptivas Funciones numéricas

Valores admitidos:

VolatileOrganicCompounds
 No compatible.

Valores admitidos:

PARTS_PER_MILLION

ESTADOS DEL DISPOSITIVO

Las entidades con este atributo pueden informar los siguientes estados como parte de la operación QUERY. Para obtener más información sobre cómo controlar intents QUERY, consulta Cómo entregar intents.

Estados Tipo Descripción
currentSensorStateData Matriz

Obligatorio.

Es la lista de los estados actuales de los sensores.
[item, ...] Objeto

Estado actual del sensor.
name String

Obligatorio.

Es el nombre del estado del sensor. Coincide con un valor de sensorStatesSupported.
currentSensorState String

Es el valor de estado descriptivo actual. Coincide con un valor de sensorStatesSupported.
rawValue Número

Es el valor actual del sensor numérico.
alarmState String

Es el estado de alarma correspondiente a la lectura actual del sensor. Es posible que se active una alarma previa o una alarma cuando las lecturas del sensor se acerquen y alcancen niveles peligrosos.

Valores admitidos:

IDLE
La alarma está inactiva; los niveles detectados no son peligrosos.
PRE_ALARM_1
Los niveles detectados son elevados, pero aún no alcanzan los niveles de emergencia. Es posible que pronto sean peligrosos.
PRE_ALARM_2
Si el dispositivo admite varias alertas antes de alcanzar los niveles de emergencia, esto indica niveles de detección más altos que PRE_ALARM_1. Los niveles siguen aumentando y es posible que pronto alcancen los niveles de emergencia.
ALARM
Los niveles detectados alcanzaron niveles de emergencia y se activó una alarma.
alarmSilenceState String

Indica el estado de silencio de la alarma del sensor, incluido si se permite silenciar una alarma activa. Este estado se puede proporcionar cuando hay un estado de alarma o de alarma previa activo.

Valores admitidos:

ALLOWED
La alarma no está silenciada y, en este momento, se permite silenciarla.
DISALLOWED
La alarma no está silenciada y, en este momento, no se permite silenciarla.
SILENCED
Se silenció la alarma.

Consulta Sensores compatibles para obtener más detalles sobre las diferentes capacidades y tipos de sensores que admite esta función.

Ejemplos

Dispositivo sensor que informa el valor de estado descriptivo.

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

Dispositivo de sensor que informa un valor de estado numérico.

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

Dispositivo de sensor que informa un valor de estado descriptivo y numérico.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

Dispositivo de sensor que informa un valor de estado descriptivo y numérico, y que indica que hay una alarma activa.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200,
      "alarmState": "ALARM",
      "alarmSilenceState": "DISALLOWED"
    }
  ]
}

COMANDOS del dispositivo

Ninguno

NOTIFICACIONES DEL DISPOSITIVO

Los dispositivos con esta característica pueden mostrar la siguiente carga útil de notificación como parte de un cambio de estado del dispositivo. Para obtener más información sobre la implementación de notificaciones, consulta Notificaciones para Acciones de casa inteligente.

Campos Tipo Descripción
SensorState Objeto

Obligatorio.

Carga útil de la notificación:
priority Número entero

Obligatorio.

Representa el nivel de notificación. El valor admitido actualmente es 0, lo que indica que la notificación se debe decir en voz alta.
name String

Obligatorio.

Es el nombre del estado del sensor. Consulta la lista de tipos de sensores compatibles para las notificaciones.
currentSensorState String

Obligatorio.

Es el valor de estado descriptivo actual. Consulta la lista de tipos de sensores compatibles para las notificaciones.

La carga útil de la notificación puede contener los siguientes tipos de sensores:

  • AirQuality
  • CarbonMonoxideLevel
  • SmokeLevel
  • FilterCleanliness
  • WaterLeak
  • RainDetection
  • FilterLifeTime

Consulta Sensores compatibles para obtener más detalles sobre las diferentes capacidades que admite cada tipo de sensor.

Ejemplos

El detecta humo.

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

ERRORES del dispositivo

Consulta la lista completa de errores y excepciones.