Esquema de traços de SensorState de casa inteligente

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

ATRIBUTOS DO dispositivo

Dispositivos com essa característica podem relatar o seguinte atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte Fulfillment da intent.

Atributos	Tipo	Descrição
sensorStatesSupported	Array	Obrigatório. Cada objeto representa os recursos do estado do sensor com suporte no dispositivo específico. Cada sensor precisa ter pelo menos uma capacidade descritiva ou numérica. Os sensores também podem informar ambos. Nesse caso, é preferível usar o valor numérico.
[item, ...]	Object	Recursos de sensores compatíveis. Requer pelo menos 1 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 "desconhecido" é implicitamente suportado quando o sensor não retorna um valor.
[item, ...]	String	Valor de estado descritivo com suporte. Requer pelo menos 1 item.
numericCapabilities	Object	Descreve os possíveis valores numéricos que o sensor pode informar.
rawValueUnit	String	Obrigatório. Unidade numérica compatível.

Consulte Sensores compatíveis para mais detalhes sobre os diferentes e os tipos de sensor compatíveis com essa característica.

Exemplos

Dispositivo sensor que informa o valor descritivo do estado.

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

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

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

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

{
  "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	Capacidades numéricas
Valores compatíveis: AirQuality	Valores compatíveis: healthy moderate unhealthy unhealthy for sensitive groups very unhealthy hazardous good fair poor very poor severe unknown	Valores compatíveis: AQI

Monóxido de carbono

Nome	Recursos descritivos	Capacidades numéricas
Valores compatíveis: CarbonMonoxideLevel	Valores compatíveis: carbon monoxide detected high no carbon monoxide detected unknown	Valores compatíveis: PARTS_PER_MILLION

Nível de fumaça

Nome	Recursos descritivos	Capacidades numéricas
Valores compatíveis: SmokeLevel	Valores compatíveis: smoke detected high no smoke detected unknown	Valores compatíveis: PARTS_PER_MILLION

Limpeza do filtro

Nome	Recursos descritivos	Capacidades numéricas
Valores compatíveis: FilterCleanliness	Valores compatíveis: clean dirty needs replacement unknown	Incompatível.

Vazamento de água

Nome	Recursos descritivos	Capacidades numéricas
Valores compatíveis: WaterLeak	Valores compatíveis: leak no leak unknown	Incompatível.

Detecção de chuva

Nome	Recursos descritivos	Capacidades numéricas
Valores compatíveis: RainDetection	Valores compatíveis: rain detected no rain detected unknown	Incompatível.

Duração do filtro

Nome	Recursos descritivos	Capacidades numéricas
Valores compatíveis: FilterLifeTime	Valores compatíveis: new good replace soon replace now unknown	Valores compatíveis: PERCENTAGE

Ciclo de vida do filtro calculado

Nome	Recursos descritivos	Capacidades numéricas
Valores compatíveis: PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	Incompatível.	Valores compatíveis: PERCENTAGE

Nível de dióxido de carbono

Nome	Recursos descritivos	Capacidades numéricas
Valores compatíveis: CarbonDioxideLevel	Incompatível.	Valores compatíveis: PARTS_PER_MILLION

Partículas em suspensão

Nome	Recursos descritivos	Capacidades numéricas
Valores compatíveis: PM2.5 PM10	Incompatível.	Valores compatíveis: MICROGRAMS_PER_CUBIC_METER

Compostos orgânicos voláteis

Nome	Recursos descritivos	Capacidades numéricas
Valores compatíveis: VolatileOrganicCompounds	Incompatível.	Valores compatíveis: PARTS_PER_MILLION

STATES do dispositivo

Entidades com essa característica podem relatar o seguinte como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte Fulfillment da intent.

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 atual do estado descritivo. Corresponde a um valor de sensorStatesSupported.
rawValue	Número	Valor atual do sensor numérico.

Consulte Sensores compatíveis para mais detalhes sobre os diferentes e os tipos de sensor compatíveis com essa característica.

Exemplos

Dispositivo sensor que informa o valor descritivo do estado.

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

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

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

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

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

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 de 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 compatível atualmente é 0, o que indica que a notificação deve ser falada em voz alta.
name	String	Obrigatório. Nome do estado do sensor. Confira a lista de tipos de sensor compatíveis com as notificações.
currentSensorState	String	Obrigatório. Valor atual do estado descritivo. Confira a lista de tipos de sensor compatíveis com as notificações.

O payload de 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 com suporte em cada tipo de sensor.

Exemplos

O detecta fumaça.

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

ERROS no dispositivo

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