Esta é a Central do desenvolvedor do Google Home, a nova plataforma para aprender a desenvolver ações de casa inteligente. Observação: você continua criando ações no Console do Actions.
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esquema de características de casa inteligente SensorState

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 como processar 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 o dispositivo específico. Cada sensor precisa ter pelo menos um recurso descritivo ou numérico. Os sensores também podem gerar relatórios sobre ambos. Nesse caso, o valor numérico será preferível.

[item, ...] Object

Recursos de sensor compatíveis.

Requer 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" recebe suporte implícito quando o sensor não retorna um valor.

[item, ...] String

Valor de 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 com sensor que informa o valor do estado descritivo.

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

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

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

Dispositivo com 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 sensor compatíveis e os recursos associados a eles.

Qualidade do ar

Name Recursos descritivos Capacidades numéricas

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

Name Recursos descritivos Capacidades numéricas

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

Name Recursos descritivos Capacidades numéricas

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

Name Recursos descritivos Capacidades numéricas

Os valores suportados são:

FilterCleanliness

Os valores suportados são:

clean
dirty
needs replacement
unknown
Incompatível.

Vazamento de água

Name Recursos descritivos Capacidades numéricas

Os valores suportados são:

WaterLeak

Os valores suportados são:

leak
no leak
unknown
Incompatível.

Detecção de chuva

Name Recursos descritivos Capacidades numéricas

Os valores suportados são:

RainDetection

Os valores suportados são:

rain detected
no rain detected
unknown
Incompatível.

Duração do filtro

Name Recursos descritivos Capacidades numéricas

Os valores suportados são:

FilterLifeTime

Os valores suportados são:

new
good
replace soon
replace now
unknown

Os valores suportados são:

PERCENTAGE

Duração do filtro calculado

Name Recursos descritivos Capacidades numéricas

Os valores suportados são:

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
Incompatível.

Os valores suportados são:

PERCENTAGE

Nível de dióxido de carbono

Name Recursos descritivos Capacidades numéricas

Os valores suportados são:

CarbonDioxideLevel
Incompatível.

Os valores suportados são:

PARTS_PER_MILLION

Matéria particulada

Name Recursos descritivos Capacidades numéricas

Os valores suportados são:

PM2.5
PM10
Incompatível.

Os valores suportados são:

MICROGRAMS_PER_CUBIC_METER

Compostos orgânicos voláteis

Name Recursos descritivos Capacidades numéricas

Os valores suportados são:

VolatileOrganicCompounds
Incompatível.

Os valores suportados são:

PARTS_PER_MILLION

STATES do dispositivo

Entidades com essa característica podem relatar os estados a seguir como parte da operação QUERY. Para saber mais sobre como processar 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 de 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 com sensor que informa o valor do estado descritivo.

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

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

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

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

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

Comandos do dispositivo

Nenhuma.

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 aceito 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 sensor compatíveis para notificações.

currentSensorState String

Obrigatório.

Valor de estado descritivo atual. Veja a lista de tipos de sensor 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.