Esquema de características do SensorState da casa inteligente

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

ATRIBUTOS do dispositivo

Os dispositivos com essa característica podem informar os seguintes atributos como parte da operação SYNC. Para saber mais sobre como lidar com intents SYNC, consulte fulfillment de intent.

Atributos	Tipo	Descrição
sensorStatesSupported	Array	Obrigatório. Cada objeto representa os recursos de estado do sensor compatíveis com este dispositivo específico. Cada sensor precisa ter pelo menos um recurso descritivo ou numérico. Os sensores também podem informar ambos, caso em que o valor numérico terá preferência.
[item, ...]	Object	Recursos de sensor compatíveis. Requer pelo menos um item.
name	String	Obrigatório. Tipo de sensor compatível. Consulte a tabela "Sensors 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" é implicitamente aceito quando o sensor não retorna um valor.
[item, ...]	String	Valor do estado descritivo compatível. Requer 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 compatível.

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

Exemplos

Dispositivo sensor que relata valor de estado descritivo.

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

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

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

Dispositivo sensor que informa valor do 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 sensor compatíveis e os recursos associados.

Qualidade do ar

Nome	Recursos descritivos	Recursos numéricos
Os valores suportados são: AirQuality	Os valores suportados são: healthy moderate unhealthy unhealthy for sensitive groups very unhealthy hazardous good fair poor very poor severe unknown	Os valores suportados são: AQI

Monóxido de carbono

Nome	Recursos descritivos	Recursos numéricos
Os valores suportados são: CarbonMonoxideLevel	Os valores suportados são: carbon monoxide detected high no carbon monoxide detected unknown	Os valores suportados são: PARTS_PER_MILLION

Nível de fumaça

Nome	Recursos descritivos	Recursos numéricos
Os valores suportados são: SmokeLevel	Os valores suportados são: smoke detected high no smoke detected unknown	Os valores suportados são: PARTS_PER_MILLION

Limpeza do filtro

Nome	Recursos descritivos	Recursos numéricos
Os valores suportados são: FilterCleanliness	Os valores suportados são: clean dirty needs replacement unknown	Incompatível.

Vazamento de água

Nome	Recursos descritivos	Recursos numéricos
Os valores suportados são: WaterLeak	Os valores suportados são: leak no leak unknown	Incompatível.

Detecção de chuva

Nome	Recursos descritivos	Recursos numéricos
Os valores suportados são: RainDetection	Os valores suportados são: rain detected no rain detected unknown	Incompatível.

Filtrar ciclo de vida

Nome	Recursos descritivos	Recursos numéricos
Os valores suportados são: FilterLifeTime	Os valores suportados são: new good replace soon replace now unknown	Os valores suportados são: PERCENTAGE

Ciclo de vida do filtro calculado

Nome	Recursos descritivos	Recursos numéricos
Os valores suportados são: PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	Incompatível.	Os valores suportados são: PERCENTAGE

Nível de dióxido de carbono

Nome	Recursos descritivos	Recursos numéricos
Os valores suportados são: CarbonDioxideLevel	Incompatível.	Os valores suportados são: PARTS_PER_MILLION

Matéria particulada

Nome	Recursos descritivos	Recursos numéricos
Os valores suportados são: PM2.5 PM10	Incompatível.	Os valores suportados são: MICROGRAMS_PER_CUBIC_METER

Compostos orgânicos voláteis

Nome	Recursos descritivos	Recursos numéricos
Os valores suportados são: VolatileOrganicCompounds	Incompatível.	Os valores suportados são: PARTS_PER_MILLION

STATES do dispositivo

As entidades com essa característica podem informar os estados a seguir como parte da operação QUERY. Para saber mais sobre como lidar com intents QUERY, consulte fulfillment de 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 do estado descritivo atual. Corresponde a um valor de sensorStatesSupported.
rawValue	Número	Valor do sensor numérico atual.

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

Exemplos

Dispositivo sensor que relata valor de estado descritivo.

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

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

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

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

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

Dispositivo COMMANDS

Nenhuma.

NOTIFICAÇÕES do dispositivo

Os dispositivos com essa característica podem retornar o payload de notificação a seguir como parte de uma mudança de estado do dispositivo. Para saber mais sobre como implementar 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 suportado atualmente é 0, o que indica que a notificação deve ser falada em voz alta.
name	String	Obrigatório. Nome do estado do sensor. Veja a lista de tipos de sensores compatíveis para notificações.
currentSensorState	String	Obrigatório. Valor do estado descritivo atual. Veja a lista de tipos de sensores compatíveis 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 ver mais detalhes sobre os diferentes recursos compatíveis com cada tipo de sensor.

Exemplos

O detecta fumaça.

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

Dispositivo ERRORS

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