Руководство по датчикам для умного дома
action.devices.types.SENSOR - Один датчик может выполнять несколько функций, например, контролировать как температуру, так и влажность. Датчики могут сообщать как количественные, так и качественные данные (например, уровень оксида углерода и дыма, измеряемый в частях на миллион) (например, является ли качество воздуха здоровым или нездоровым).
Этот тип указывает, что устройство получает значок датчика и некоторые связанные с ним синонимы и псевдонимы.
Возможности устройства
Подробную информацию о реализации, например, атрибуты и состояния, которые должна поддерживать ваша служба, а также о том, как создавать ответы EXECUTE и QUERY, см. в соответствующей документации по характеристикам.
Рекомендуемые черты
Эти характеристики рекомендуются, если применимы к вашему устройству. Тем не менее, вы можете свободно смешивать и подбирать из всех доступных характеристик, чтобы наилучшим образом соответствовать функциональности вашего существующего продукта.
Датчики могут также использовать другие характеристики, охватывающие данные, которые они могут сообщать, например:
- HumiditySetting
- OpenClose
- TemperatureControl — используется для температур, не связанных с климатом (температура воды, поверхности, внутренняя часть устройства).
- TemperatureSetting — используется для климатических температур (окружающего воздуха).
Требования к качеству
- Задержка: должна быть меньше или равна 1000 мс .
- Надежность: должна быть больше или равна 97% .
Пример устройства: простой датчик
В этом разделе содержатся примеры полезных нагрузок намерений, представляющих собой общий "датчик" на основе типа устройства и характеристик выше. Если вы добавляете или удаляете характеристики в своей реализации, измените свои ответы соответствующим образом, чтобы отразить эти изменения.
Пример ответа 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.OccupancySensing", "action.devices.traits.SensorState" ], "name": { "name": "Simple sensor" }, "willReportState": true, "attributes": { "sensorStatesSupported": [ { "name": "AirQuality", "descriptiveCapabilities": { "availableStates": [ "healthy", "moderate", "unhealthy", "very unhealthy" ] } } ], "queryOnlyEnergyStorage": true, "occupancySensorConfiguration": [ { "occupancySensorType": "PIR", "occupiedToUnoccupiedDelaySec": 10, "unoccupiedToOccupiedDelaySec": 10, "unoccupiedToOccupiedEventThreshold": 2 } ] }, "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 } ], "occupancy": "OCCUPIED" } } } }