מדריך לריכוך מים לבית חכם
action.devices.types.WATERSOFTENER
– מרככי מים הם מכשירים שאפשר להפעיל או להשבית, שמדווחים על רמת הניקיון של מסנני המים ועל משך החיים של המסנן. אפשר גם לשנות את הגדרות המצב שלהם.
הסוג הזה מציין שהמכשיר מקבל את הסמל 'מרכך מים' וכמה מילים נרדפות וכינויים קשורים.
יכולות המכשיר
עיינו בתיעוד של התכונה המתאימה כדי לראות את פרטי ההטמעה, כמו מאפיינים ומצבים שבהם השירות צריך לתמוך, ואיך ליצור תשובות ב-EXECUTE וב-QUERY.
תכונות מומלצות
התכונות האלה מומלצות למכשיר שלכם, אם הן רלוונטיות. עם זאת, תוכלו לשלב ולהתאים בין כל התכונות הזמינות כדי להתאים בצורה הטובה ביותר לפונקציונליות הקיימת של המוצר.
דרישות איכות
- זמן האחזור:חייב להיות 800 אלפיות שנייה או פחות.
- אמינות: הערך צריך להיות 97% או יותר.
מכשיר לדוגמה: מרכך מים פשוט
בקטע הזה יש דוגמאות של מטענים ייעודיים (payloads) של Intent שמייצגים 'מרכך מים' נפוץ על סמך סוג המכשיר והתכונות שצוינו למעלה. אם מוסיפים או מסירים תכונות בהטמעה, צריך לשנות את התשובות בהתאם.
תגובת SYNC לדוגמה
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.WATERSOFTENER", "traits": [ "action.devices.traits.OnOff", "action.devices.traits.SensorState" ], "name": { "name": "Simple water softener" }, "willReportState": true, "attributes": { "sensorStatesSupported": [ { "name": "FilterCleanliness", "descriptiveCapabilities": { "availableStates": [ "clean", "dirty", "needs replacement" ] } } ] }, "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, "on": true, "currentSensorStateData": [ { "name": "FilterCleanliness", "currentSensorState": "clean" } ] } } } }
פקודות EXECUTE לדוגמה
OnOff
לפרטים נוספים על הפרמטרים של הפקודות, אפשר לעיין בחומר העזר בנושא
action.devices.traits.OnOff
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }