智慧型住宅感應器指南
action.devices.types.SENSOR
- 單一感應器可以提供多項功能,例如監控溫度和濕度。感應器可回報定量或兩者皆有的量化數據 (例如一氧化碳和煙霧濃度的測量單位,單位為百萬分之一) 以及定性測量結果 (例如空氣品質是否良好或不良)。
這種類型表示裝置會接收感應器圖示,以及一些相關的同義詞與別名。
裝置功能
請參閱對應的特性說明文件,瞭解服務應支援的屬性和狀態,以及如何建構 EXECUTE 和 QUERY 回應。
推薦特色
視您的裝置而定,我們建議採用這類特性。 不過,您可以自由搭配所有可用特徵,並配合現有的產品功能進行配對。
感應器也可能使用其他特徵來回報可回報的資料,例如:
品質規定
- 延遲時間:必須小於或等於 1000 毫秒。
- 可靠性:必須大於或等於 97%。
範例裝置:簡易感應器
本節包含代表上述裝置類型和特徵的常見意圖感應器酬載範例。如果您在實作中新增或移除特性,請配合這些異動修改回應。
同步處理回應範例
{ "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" } } ] } }
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 } ] } } } }