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:
|
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. |
Filtrar ciclo de vida
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:
|
Matéria particulada
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
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 |
currentSensorState |
String |
Valor do estado descritivo atual. Corresponde a um valor de |
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
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }