Руководство по датчикам для умного дома
action.devices.types.SENSOR — один датчик может выполнять несколько функций, например, контролировать температуру и влажность. Датчики могут предоставлять как количественные, так и качественные данные (например, уровень угарного газа и дыма, измеряемый в миллионных долях), а также данные обоих типов (например, о качестве воздуха).
Этот тип указывает, что устройство получает значок датчика и некоторые связанные с ним синонимы и псевдонимы.
Возможности устройства
Подробную информацию о реализации, например, об атрибутах и состояниях, которые должна поддерживать ваша служба, а также о том, как создавать ответы EXECUTE и QUERY, см. в соответствующей документации по характеристикам.
Рекомендуемые черты
Эти характеристики рекомендуются, если они применимы к вашему устройству. Однако вы можете комбинировать все доступные характеристики, чтобы наилучшим образом соответствовать функционалу вашего устройства.
Датчики могут также использовать другие характеристики, охватывающие данные, которые они могут сообщать, например:
- HumiditySetting
- OpenClose
- TemperatureControl - используется для температур, не связанных с климатом (температура воды, поверхности, внутренней части устройства).
- TemperatureSetting - используется для климатических температур (температуры окружающего воздуха).
Пример устройства: простой датчик
В этом разделе приведены примеры полезных нагрузок 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.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" } } } }