Руководство по датчику умного дома
action.devices.types.SENSOR
. Один датчик может выполнять несколько функций, например контролировать температуру и влажность или температуру и присутствие людей. Датчики могут сообщать как количественные (например, уровень угарного газа и дыма, измеряемые в частях на миллион), так и качественные измерения, например, является ли качество воздуха здоровым или нездоровым.
Этот тип указывает, что устройство получает значок датчика и некоторые связанные с ним синонимы и псевдонимы.
Возможности устройства
Подробности реализации, такие как атрибуты и состояния, которые должна поддерживать ваша служба, а также способы построения ответов EXECUTE и QUERY см. в соответствующей документации по трейтам.
Рекомендуемые черты
Эти характеристики рекомендуются, если применимы к вашему устройству. Тем не менее, вы можете смешивать и сочетать все доступные черты, чтобы наилучшим образом соответствовать функциональным возможностям вашего существующего продукта.
-
action.devices.traits.SensorState
-
action.devices.traits.EnergyStorage
-
action.devices.traits.OccupancySensing
Датчики могут также использовать другие признаки, охватывающие данные, которые они могут сообщать, например:
Требования к качеству
- Задержка: должна быть меньше или равна 1000 мс .
- Надежность: должна быть больше или равна 97% .
Пример устройства: простой датчик
Этот раздел содержит примеры полезной нагрузки Intent, представляющей общий «датчик» на основе типа устройства и характеристик, указанных выше. Если вы добавляете или удаляете черты в своей реализации, измените свои ответы соответствующим образом, чтобы отразить эти изменения.
Пример ответа 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" } } ] } }
Пример ответа на ЗАПРОС
{ "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 } ] } } } }