智慧型住宅百葉窗指南
action.devices.types.BLINDS
- 百葉窗可以打開和關上,並且支援多種百葉窗類型,例如純素(單向開啟)、面板或垂直 (可向左或向右開啟),以及由下而下 (可由上往下)。部分百葉窗可能有可旋轉的板條。
這種類型表示裝置會獲得百葉窗圖示,以及一些相關的同義詞和別名。
裝置功能
請參閱對應的特性說明文件,瞭解服務應支援的屬性和狀態,以及如何建構 EXECUTE 和 QUERY 回應。
必修特色
這些特性和指令 (如果適用於您的裝置)。
推薦特色
視您的裝置而定,我們建議採用這類特性。 不過,您可以自由搭配所有可用特徵,並配合現有的產品功能進行配對。
品質規定
- 延遲時間:必須小於或等於 2500 毫秒。
- 可靠性:必須大於或等於 97%。
範例裝置:簡易百葉窗
本節包含代表上述裝置類型和特徵的常見意圖酬載範例,代表常見的「百葉窗」。如果您在實作中新增或移除特性,請配合這些異動修改回應。
在由下而下的窗型百葉窗中,UP
方向會提升百葉窗的底部,而 DOWN
方向會降低百葉窗的頂部。圖 1 顯示由上而下的百葉窗範例,其中 UP
方向將百葉窗的底部提高 50%,DOWN
方向則將百葉窗的上部降低 30%。

同步處理回應範例
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.BLINDS", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple blinds" }, "willReportState": true, "attributes": { "openDirection": [ "UP", "DOWN" ] }, "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, "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] } } } }
EXECUTE 指令範例
OpenClose
如要進一步瞭解指令參數,請參閱
action.devices.traits.OpenClose
參考資料。
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenClose", "params": { "openPercent": 10, "openDirection": "DOWN" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openState": [ { "openPercent": 10, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] } } ] } }