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:
|
Os valores suportados são:
|
Os valores suportados são:
|
Monóxido de carbono
Name | Recursos descritivos | Capacidades numéricas |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Os valores suportados são:
|
Nível de fumaça
Name | Recursos descritivos | Capacidades numéricas |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Os valores suportados são:
|
Limpeza do filtro
Name | Recursos descritivos | Capacidades numéricas |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Incompatível. |
Vazamento de água
Name | Recursos descritivos | Capacidades numéricas |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Incompatível. |
Detecção de chuva
Name | Recursos descritivos | Capacidades numéricas |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Incompatível. |
Duração do filtro
Name | Recursos descritivos | Capacidades numéricas |
---|---|---|
Os valores suportados são:
|
Os valores suportados são:
|
Os valores suportados são:
|
Duração do filtro calculado
Name | Recursos descritivos | Capacidades numéricas |
---|---|---|
Os valores suportados são:
|
Incompatível. | Os valores suportados são:
|
Nível de dióxido de carbono
Name | Recursos descritivos | Capacidades numéricas |
---|---|---|
Os valores suportados são:
|
Incompatível. | Os valores suportados são:
|
Matéria particulada
Name | Recursos descritivos | Capacidades numéricas |
---|---|---|
Os valores suportados são:
|
Incompatível. | Os valores suportados são:
|
Compostos orgânicos voláteis
Name | Recursos descritivos | Capacidades numéricas |
---|---|---|
Os valores suportados são:
|
Incompatível. | Os valores suportados são:
|
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 |
currentSensorState |
String |
Valor de 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 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
{ "SensorState": { "priority": 0, "name": "SmokeLevel", "currentSensorState": "high" } }