Esquema de trait de sensorState de la casa inteligente

action.devices.traits.SensorState: Esta característica abarca la medición cuantitativa y el estado cualitativo.

ATRIBUTOS DISPOSITIVOS

Los dispositivos con este trait pueden informar lo siguiente atributos como parte de la operación SYNC. Para aprender Para obtener más información sobre cómo controlar los intents SYNC, consulta Entrega de 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	Capacidades de sensores compatibles. Requiere al menos 1 elemento.
name	String	Obligatorio. Tipo de sensor compatible. Consulta la tabla de sensores compatibles.
descriptiveCapabilities	Objeto	Es una descripción de las capacidades del sensor.
availableStates	Matriz	Obligatorio. Lista de los estados disponibles para el dispositivo. Lo "desconocido" se admite de forma implícita cuando el sensor no devuelve un valor.
[item, ...]	String	Valor de estado descriptivo admitido. Requiere al menos 1 elemento.
numericCapabilities	Objeto	Describe los posibles valores numéricos que el sensor puede informar.
rawValueUnit	String	Obligatorio. Unidad numérica admitida.

Consulta Sensores compatibles para obtener más detalles sobre los diferentes y tipos de sensores que admite esta característica.

Ejemplos

Dispositivo sensor que informa un valor de estado descriptivo.

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

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

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

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	Capacidades 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	Capacidades 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	Capacidades 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	Capacidades numéricas
Valores admitidos: FilterCleanliness	Valores admitidos: clean dirty needs replacement unknown	No compatible.

Fuga de agua

Nombre	Capacidades descriptivas	Capacidades numéricas
Valores admitidos: WaterLeak	Valores admitidos: leak no leak unknown	No compatible.

Detección de lluvia

Nombre	Capacidades descriptivas	Capacidades numéricas
Valores admitidos: RainDetection	Valores admitidos: rain detected no rain detected unknown	No compatible.

Vida útil del filtro

Nombre	Capacidades descriptivas	Capacidades 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	Capacidades numéricas
Valores admitidos: PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	No compatible.	Valores admitidos: PERCENTAGE

Nivel de dióxido de carbono

Nombre	Capacidades descriptivas	Capacidades numéricas
Valores admitidos: CarbonDioxideLevel	No compatible.	Valores admitidos: PARTS_PER_MILLION

Material particulado

Nombre	Capacidades descriptivas	Capacidades numéricas
Valores admitidos: PM2.5 PM10	No compatible.	Valores admitidos: MICROGRAMS_PER_CUBIC_METER

Compuestos orgánicos volátiles

Nombre	Capacidades descriptivas	Capacidades numéricas
Valores admitidos: VolatileOrganicCompounds	No compatible.	Valores admitidos: PARTS_PER_MILLION

Dispositivo STATES

Las entidades con esta característica pueden informar lo siguiente estados como parte de la operación QUERY. Para aprender Para obtener más información sobre cómo controlar los intents QUERY, consulta Entrega de intents.

Estados	Tipo	Descripción
currentSensorStateData	Matriz	Obligatorio. Lista de los estados actuales de los sensores.
[item, ...]	Objeto	Estado actual del sensor.
name	String	Obligatorio. Nombre del estado del sensor. Coincide con un valor de sensorStatesSupported.
currentSensorState	String	Valor de estado descriptivo actual. Coincide con un valor de sensorStatesSupported.
rawValue	Número	Valor numérico actual del sensor

Consulta Sensores compatibles para obtener más detalles sobre los diferentes y tipos de sensores que admite esta característica.

Ejemplos

Dispositivo sensor que informa un valor de estado descriptivo.

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

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

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

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

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

COMANDOS del dispositivo

Ninguno

NOTIFICACIONES DEL DISPOSITIVO

Los dispositivos con este trait pueden devolver lo siguiente: útil de notificaciones como parte de un cambio de estado del dispositivo. Para aprender para implementar 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 leer en voz alta.
name	String	Obligatorio. Nombre del estado del sensor. Consulta la lista de tipos de sensores admitidos para recibir notificaciones.
currentSensorState	String	Obligatorio. Valor de estado descriptivo actual. Consulta la lista de tipos de sensores admitidos para recibir notificaciones.

La carga útil de notificaciones puede contener los siguientes tipos de sensores:

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

Consulta Sensores compatibles para obtener más detalles sobre los diferentes capacidades compatibles con cada tipo de sensor.

Ejemplos

El detecta humo.

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

ERRORES DE DISPOSITIVO

Consulta la lista completa de errores y excepciones.