Esquema de rasgo de SensorState de casa inteligente
action.devices.traits.SensorState
: Esta característica abarca tanto la medición cuantitativa como el estado cualitativo.
Dispositivo ATTRIBUTES
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 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 dará prioridad al 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 |
Una descripción de las capacidades del sensor. |
availableStates |
Matriz |
Obligatorio. 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. Requiere al menos 1 elemento. |
numericCapabilities |
Objeto |
Describe los valores numéricos posibles que el sensor puede informar. |
rawValueUnit |
String |
Obligatorio. Unidad numérica admitida. |
Consulta la sección Sensores compatibles para obtener más detalles sobre las diferentes capacidades y los tipos de sensores que admite esta característica.
Ejemplos
Dispositivo de sensor que informa un valor de estado descriptivo.
{ "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ] }
Dispositivo 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 compatibles y sus capacidades asociadas.
Calidad del aire
Nombre | Capacidades descriptivas | Capacidades numéricas |
---|---|---|
Valores admitidos:
|
Valores admitidos:
|
Valores admitidos:
|
Monóxido de carbono
Nombre | Capacidades descriptivas | Capacidades numéricas |
---|---|---|
Valores admitidos:
|
Valores admitidos:
|
Valores admitidos:
|
Nivel de humo
Nombre | Capacidades descriptivas | Capacidades numéricas |
---|---|---|
Valores admitidos:
|
Valores admitidos:
|
Valores admitidos:
|
Estado del filtro
Nombre | Capacidades descriptivas | Capacidades numéricas |
---|---|---|
Valores admitidos:
|
Valores admitidos:
|
No compatible. |
Pérdida de agua
Nombre | Capacidades descriptivas | Capacidades numéricas |
---|---|---|
Valores admitidos:
|
Valores admitidos:
|
No compatible. |
Detección de lluvia
Nombre | Capacidades descriptivas | Capacidades numéricas |
---|---|---|
Valores admitidos:
|
Valores admitidos:
|
No compatible. |
Vida útil del filtro
Nombre | Capacidades descriptivas | Capacidades numéricas |
---|---|---|
Valores admitidos:
|
Valores admitidos:
|
Valores admitidos:
|
Duración del filtro calculado
Nombre | Capacidades descriptivas | Capacidades numéricas |
---|---|---|
Valores admitidos:
|
No compatible. | Valores admitidos:
|
Nivel de dióxido de carbono
Nombre | Capacidades descriptivas | Capacidades numéricas |
---|---|---|
Valores admitidos:
|
No compatible. | Valores admitidos:
|
Material particulado
Nombre | Capacidades descriptivas | Capacidades numéricas |
---|---|---|
Valores admitidos:
|
No compatible. | Valores admitidos:
|
Compuestos orgánicos volátiles
Nombre | Capacidades descriptivas | Capacidades numéricas |
---|---|---|
Valores admitidos:
|
No compatible. | Valores admitidos:
|
Dispositivo STATES
Las entidades con esta característica pueden informar los siguientes estados como parte de la operación QUERY
. 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 del sensor. |
[item, ...] |
Objeto |
Estado actual del sensor. |
name |
String |
Obligatorio. Nombre del estado del sensor. Coincide con un valor de |
currentSensorState |
String |
Valor de estado descriptivo actual. Coincide con un valor de |
rawValue |
Número |
Valor actual del sensor numérico. |
Consulta la sección Sensores compatibles para obtener más detalles sobre las diferentes capacidades y los tipos de sensores que admite esta característica.
Ejemplos
Dispositivo de sensor que informa un valor de estado descriptivo.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Dispositivo 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 } ] }
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 pronunciar 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 la notificación puede contener los siguientes tipos de sensores:
AirQuality
CarbonMonoxideLevel
SmokeLevel
FilterCleanliness
WaterLeak
RainDetection
FilterLifeTime
Consulta la sección Sensores compatibles para obtener más detalles sobre las diferentes capacidades que admite cada tipo de sensor.
Ejemplos
El
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }