Esquema de atributo SensorState da casa inteligente

action.devices.traits.SensorState: essa característica abrange a medição quantitativa e o estado qualitativo.

ATRIBUTOS do dispositivo

Dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre o processamento de intents SYNC, consulte Fulfillment de intents.

Atributos Tipo Descrição
sensorStatesSupported Array

Obrigatório.

Cada objeto representa os recursos de estado do sensor compatíveis com esse dispositivo específico. Cada sensor precisa ter pelo menos um recurso descritivo ou numérico. Os sensores também podem informar os dois, e o valor numérico será preferido.
[item, ...] Object

Recursos de sensor com suporte.

É necessário selecionar pelo menos um item.
name String

Obrigatório.

Tipo de sensor compatível. Consulte a tabela "Sensores compatíveis".
descriptiveCapabilities Object

Uma descrição dos recursos do sensor.
availableStates Array

Obrigatório.

Lista dos estados disponíveis para o dispositivo. O estado "desconhecido" tem suporte implícito quando o sensor não retorna um valor.
[item, ...] String

Valor de estado descritivo com suporte.

É necessário selecionar pelo menos um item.
numericCapabilities Object

Descreve os possíveis valores numéricos que o sensor pode informar.
rawValueUnit String

Obrigatório.

Unidade numérica com suporte.

Consulte Sensores compatíveis para mais detalhes sobre os diferentes recursos e tipos de sensores aceitos por esse atributo.

Exemplos

Dispositivo de sensor que informa o valor do estado descritivo.

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

Dispositivo de sensor que informa o valor do estado numérico.

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

Dispositivo de sensor que informa o valor descritivo e numérico do estado.

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

Sensores compatíveis

As tabelas a seguir listam os tipos de sensores compatíveis e os recursos associados a eles.

Qualidade do ar

Nome Recursos descritivos Recursos numéricos

Valores aceitos:

AirQuality

Valores aceitos:

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

Valores aceitos:

AQI

Monóxido de carbono

Nome Recursos descritivos Recursos numéricos

Valores aceitos:

CarbonMonoxideLevel

Valores aceitos:

carbon monoxide detected
high
no carbon monoxide detected
unknown

Valores aceitos:

PARTS_PER_MILLION

Nível de fumaça

Nome Recursos descritivos Recursos numéricos

Valores aceitos:

SmokeLevel

Valores aceitos:

smoke detected
high
no smoke detected
unknown

Valores aceitos:

PARTS_PER_MILLION

Limpeza do filtro

Nome Recursos descritivos Recursos numéricos

Valores aceitos:

FilterCleanliness

Valores aceitos:

clean
dirty
needs replacement
unknown
 Incompatível.

Vazamento de água

Nome Recursos descritivos Recursos numéricos

Valores aceitos:

WaterLeak

Valores aceitos:

leak
no leak
unknown
 Incompatível.

Detecção de chuva

Nome Recursos descritivos Recursos numéricos

Valores aceitos:

RainDetection

Valores aceitos:

rain detected
no rain detected
unknown
 Incompatível.

Duração do filtro

Nome Recursos descritivos Recursos numéricos

Valores aceitos:

FilterLifeTime

Valores aceitos:

new
good
replace soon
replace now
unknown

Valores aceitos:

PERCENTAGE

Duração do filtro computado

Nome Recursos descritivos Recursos numéricos

Valores aceitos:

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
 Incompatível.

Valores aceitos:

PERCENTAGE

Nível de dióxido de carbono

Nome Recursos descritivos Recursos numéricos

Valores aceitos:

CarbonDioxideLevel
 Incompatível.

Valores aceitos:

PARTS_PER_MILLION

Partículas em suspensão

Nome Recursos descritivos Recursos numéricos

Valores aceitos:

PM2.5
PM10
 Incompatível.

Valores aceitos:

MICROGRAMS_PER_CUBIC_METER

Compostos orgânicos voláteis

Nome Recursos descritivos Recursos numéricos

Valores aceitos:

VolatileOrganicCompounds
 Incompatível.

Valores aceitos:

PARTS_PER_MILLION

ESTADOS DO DISPOSITIVO

As entidades com essa característica podem informar os seguintes estados como parte da operação QUERY. Para saber mais sobre o processamento de intents QUERY, consulte Fulfillment de intents.

Estados Tipo Descrição
currentSensorStateData Array

Obrigatório.

Lista dos estados atuais do sensor.
[item, ...] Object

Estado atual do sensor.
name String

Obrigatório.

Nome do estado do sensor. Corresponde a um valor de sensorStatesSupported.
currentSensorState String

Valor do estado descritivo atual. Corresponde a um valor de sensorStatesSupported.
rawValue Número

Valor atual do sensor numérico.
alarmState String

O estado do alarme correspondente à leitura atual do sensor. Um pré-alarme ou alarme pode ser acionado quando as leituras do sensor se aproximam e atingem níveis perigosos.

Valores aceitos:

IDLE
O alarme está inativo. Os níveis detectados não são perigosos.
PRE_ALARM_1
Os níveis detectados estão elevados, mas ainda não atingiram o nível de emergência. Em breve, eles podem se tornar perigosos.
PRE_ALARM_2
Se o dispositivo oferecer suporte a vários alertas antes de atingir os níveis de emergência, isso indica níveis de detecção mais altos do que PRE_ALARM_1. Os níveis continuam aumentando e podem chegar aos níveis de emergência em breve.
ALARM
Os níveis detectados atingiram níveis de emergência e um alarme foi acionado.
alarmSilenceState String

Indica o estado de silêncio do alarme do sensor, incluindo se o silenciamento de um alarme ativo é permitido no momento. Esse estado pode ser fornecido quando um estado de pré-alarme ou alarme está ativo.

Valores aceitos:

ALLOWED
O alarme não está silenciado e o silenciamento está permitido no momento.
DISALLOWED
O alarme não está silenciado, e o silenciamento não é permitido no momento.
SILENCED
O alarme foi silenciado.

Consulte Sensores compatíveis para mais detalhes sobre os diferentes recursos e tipos de sensores aceitos por esse atributo.

Exemplos

Dispositivo de sensor que informa o valor do estado descritivo.

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

Dispositivo de sensor que informa o valor do estado numérico.

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

Dispositivo de sensor que informa o valor descritivo e numérico do estado.

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

Dispositivo de sensor que informa o valor descritivo e numérico do estado e indica que um alarme está ativo.

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

COMANDOS do dispositivo

Nenhum.

NOTIFICAÇÕES do dispositivo

Dispositivos com essa característica podem retornar o seguinte payload de notificação como parte de uma mudança de estado do dispositivo. Para saber mais sobre a implementação de notificações, consulte Notificações para ações de casa inteligente.

Campos Tipo Descrição
SensorState Object

Obrigatório.

Payload de notificação:
priority Número inteiro

Obrigatório.

Representa o nível de notificação. O valor aceito no momento é 0, o que indica que a notificação precisa ser lida em voz alta.
name String

Obrigatório.

Nome do estado do sensor. Consulte a lista de tipos de sensores com suporte para notificações.
currentSensorState String

Obrigatório.

Valor do estado descritivo atual. Consulte a lista de tipos de sensores com suporte para notificações.

O payload da notificação pode conter os seguintes tipos de sensor:

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

Consulte Sensores compatíveis para mais detalhes sobre os diferentes recursos aceitos por cada tipo de sensor.

Exemplos

O detecta fumaça.

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

ERROS do dispositivo

Confira a lista completa de erros e exceções.