Guia dos sensores de casa inteligente
action.devices.types.SENSOR
: um único sensor pode desempenhar várias funções, como monitorar a temperatura e umidade ou a temperatura e a ocupação. Os sensores podem informar medições quantitativas ou quantitativas, como monóxido de carbono e nível de fumaça medidos em partes por milhão, e qualitativas, como se a qualidade do ar está saudável ou não.
Esse tipo indica que o dispositivo recebe o ícone do sensor e alguns sinônimos e aliases relacionados.
Recursos do dispositivo
Consulte a documentação de características correspondentes para ver detalhes da implementação, como atributos e estados aos quais seu serviço precisa oferecer suporte e como criar respostas de EXECUTE e CONSULTA.
Características recomendadas
Estas características são recomendadas, se aplicável ao seu dispositivo. No entanto, é possível combinar todas as características disponíveis para que elas correspondam melhor à funcionalidade do produto atual.
-
action.devices.traits.SensorState
-
action.devices.traits.EnergyStorage
-
action.devices.traits.OccupancySensing
Os sensores também podem usar outras características para cobrir os dados que podem informar, como:
Requisitos de qualidade
- Latência: precisa ser inferior ou igual a 1.000 ms.
- Confiabilidade: precisa ser maior ou igual a 97%.
Exemplo de dispositivo: sensor simples
Esta seção contém exemplos de payloads de intent que representam um "Sensor" comum com base no tipo de dispositivo e nas características acima. Se você adicionar ou remover características da sua implementação, modifique suas respostas para refletir essas alterações.
Exemplo de resposta SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.SENSOR", "traits": [ "action.devices.traits.EnergyStorage", "action.devices.traits.SensorState" ], "name": { "name": "Simple sensor" }, "willReportState": true, "attributes": { "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ], "queryOnlyEnergyStorage": true }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
Exemplo de resposta de QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true, "currentSensorStateData": [ { "name": "AirQuality", "currentSensorState": "healthy" } ], "descriptiveCapacityRemaining": "HIGH", "capacityRemaining": [ { "unit": "PERCENTAGE", "rawValue": 90 } ] } } } }