Esquema do traço 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 informar os seguintes
atributos como parte da operação SYNC
. Para saber
mais sobre o gerenciamento de intents SYNC
, consulte
fulfillment de intents.
Atributos | Tipo | Descrição |
---|---|---|
sensorStatesSupported |
Array |
Obrigatório. Cada objeto representa as capacidades de estado do sensor compatíveis com esse dispositivo específico. Cada sensor precisa ter pelo menos uma capacidade descritiva ou numérica. Os sensores também podem informar ambos. Nesse caso, prefira o valor numérico. |
[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" é implicitamente aceito 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 sensor compatíveis com essa característica.
Exemplos
Dispositivo sensor que informa um valor de estado descritivo.
{ "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ] }
Dispositivo sensor que informa valores de estado numérico.
{ "sensorStatesSupported": [ { "name": "CarbonMonoxideLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" } } ] }
Dispositivo sensor que informa valores de estado descritivo e numérico.
{ "sensorStatesSupported": [ { "name": "SmokeLevel", "numericCapabilities": { "rawValueUnit": "PARTS_PER_MILLION" }, "descriptiveCapabilities": { "availableStates": [ "smoke detected", "high", "no smoke detected" ] } } ] }
Sensores com suporte
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 |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Os valores suportados são:
|
Monóxido de carbono
Nome | Recursos descritivos | Recursos numéricos |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Os valores suportados são:
|
Nível de fumaça
Nome | Recursos descritivos | Recursos numéricos |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Os valores suportados são:
|
Limpeza do filtro
Nome | Recursos descritivos | Recursos numéricos |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Incompatível. |
Vazamento de água
Nome | Recursos descritivos | Recursos numéricos |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Incompatível. |
Detecção de chuva
Nome | Recursos descritivos | Recursos numéricos |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Incompatível. |
Duração do filtro
Nome | Recursos descritivos | Recursos numéricos |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Os valores suportados são:
|
Ciclo de vida do filtro calculado
Nome | Recursos descritivos | Recursos numéricos |
---|---|---|
Os valores suportados são:
|
Incompatível. | Os valores suportados são:
|
Nível de dióxido de carbono
Nome | Recursos descritivos | Recursos numéricos |
---|---|---|
Os valores suportados são:
|
Incompatível. | Os valores suportados são:
|
Partículas em suspensão
Nome | Recursos descritivos | Recursos numéricos |
---|---|---|
Os valores suportados são:
|
Incompatível. | Os valores suportados são:
|
Compostos orgânicos voláteis
Nome | Recursos descritivos | Recursos numéricos |
---|---|---|
Os valores suportados são:
|
Incompatível. | Os valores suportados são:
|
STATES do dispositivo
Entidades com essa característica podem informar os seguintes estados como parte da operação QUERY
. Para saber
mais sobre o gerenciamento de intents QUERY
, consulte
fulfillment de intents.
Estados | Tipo | Descrição |
---|---|---|
currentSensorStateData |
Array |
Obrigatório. Lista de estados atuais do sensor. |
[item, ...] |
Object |
Estado atual do sensor. |
name |
String |
Obrigatório. Nome do estado do sensor. Corresponde a um valor de |
currentSensorState |
String |
Valor atual do estado descritivo. Corresponde a um valor de |
rawValue |
Número |
Valor atual do sensor numérico. |
Consulte Sensores compatíveis para ver mais detalhes sobre os diferentes recursos e tipos de sensor compatíveis com essa característica.
Exemplos
Dispositivo sensor que informa um valor de estado descritivo.
{ "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ] }
Dispositivo sensor que informa valores de estado numérico.
{ "currentSensorStateData": [ { "name": "CarbonMonoxideLevel", "rawValue": 200 } ] }
Dispositivo sensor que informa valores de estado descritivo e numérico.
{ "currentSensorStateData": [ { "name": "SmokeLevel", "currentSensorState": "smoke detected", "rawValue": 200 } ] }
Comandos do dispositivo
Nenhuma.
NOTIFICAÇÕES do dispositivo
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 compatível no momento é 0, 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 com notificações. |
currentSensorState |
String |
Obrigatório. Valor atual do estado descritivo. Veja a lista de tipos de sensores compatíveis com 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 ver mais detalhes sobre os diferentes recursos compatíveis com cada tipo de sensor.
Exemplos
O
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }