智能家居传感器指南
action.devices.types.SENSOR
- 单个传感器可以提供多项功能,例如同时监控温度和湿度。传感器可以报告定量测量结果(例如以百万分率测量的一氧化碳和烟雾水平)和定性测量结果(例如空气质量是健康还是不健康),或同时报告两者。
此类型表示设备获取传感器图标和一些相关的 同义词和别名。
设备功能
请参阅相应的特征文档, 实现细节,例如您的服务应支持的属性和状态,以及如何 建立 EXECUTE 和 QUERY 响应。
推荐特征
建议你拥有以下特征(如果适用于你的设备)。 不过,你可以随意混搭所有可用特征,使其与现有的特征最匹配 产品功能。
传感器还可能使用其他特征涵盖它们可以报告的数据,例如:
。质量要求
- 延迟时间:必须小于或等于 1000 毫秒。
- 可靠性:必须大于或等于 97%。
示例设备:简单传感器
本部分包含表示常见“传感器”的 intent 载荷示例 。如果您在实现中添加或移除 trait, 对您的回答进行相应的修改,以反映这些修改。
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" } } ] } }
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 } ], "occupancy": "OCCUPIED" } } } }