מדריך למאוורר בית חכם
action.devices.types.FAN
– בדרך כלל ניתן להפעיל ולכבות מאווררים ולקבוע הגדרות מהירות. למאווררים מסוימים יכולים להיות גם מצבים נתמכים נוספים, כמו כיוון/כיוון המאוורר (לדוגמה, ייתכן שליחידת קיר יהיו הגדרות לכוונן אם היא תפוצל למעלה או למטה).
הסוג הזה מציין שהמכשיר מקבל את סמל המאוורר וכמה מילים נרדפות וכינויים קשורים.
היכולות של המכשיר
עיינו במסמכי התיעוד של התכונה המתאימה לקבלת פרטים על ההטמעה, כמו המאפיינים והמצבים שבהם השירות צריך לתמוך, והסבר על בניית תשובות EXECUTE ו-QUERY.
התכונות הנדרשות
המאפיינים והפקודות האלה נדרשים, אם הם רלוונטיים למכשיר שלכם. אם המכשיר לא תומך בתכונות האלה, מזינים את קוד השגיאה functionNotSupported
בתשובה QUERY או EXECUTE. מידע נוסף זמין במאמר שגיאות וחריגים.
דרישות איכות
- זמן אחזור: חייב להיות קטן מ-700 אלפיות השנייה או שווה לו.
- אמינות: חייבת להיות שווה ל-97%.
מכשיר לדוגמה: מאוורר פשוט
בקטע הזה מפורטים מטענים ייעודיים לדוגמה שמייצגים "מאוורר" נפוץ, בהתאם לסוג המכשיר ולתכונות שלמעלה. אם מוסיפים או מסירים תכונות, משנים את התשובות בהתאם בהתאם לשינויים.
דוגמה לתגובת SYNC
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.FAN", "traits": [ "action.devices.traits.FanSpeed", "action.devices.traits.OnOff" ], "name": { "name": "Simple fan" }, "willReportState": true, "attributes": { "availableFanSpeeds": { "speeds": [ { "speed_name": "low_key", "speed_values": [ { "speed_synonym": [ "Low", "Slow" ], "lang": "en" }, { "speed_synonym": [ "Niedrig", "Schleppend" ], "lang": "de" } ] }, { "speed_name": "high_key", "speed_values": [ { "speed_synonym": [ "High" ], "lang": "en" }, { "speed_synonym": [ "Hoch" ], "lang": "de" } ] } ], "ordered": true }, "reversible": 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, "on": true, "currentFanSpeedSetting": "low_key" } } } }
פקודות EXECUTE לדוגמה
הגדרת SpeedFanSpeed
למידע נוסף על הפרמטרים של הפקודות, אפשר לעיין במאמר
action.devices.traits.FanSpeed
.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.SetFanSpeed", "params": { "fanSpeed": "high_key" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "currentFanSpeedSetting": "high_key" } } ] } }
מצב כבוי
למידע נוסף על הפרמטרים של הפקודות, אפשר לעיין במאמר
action.devices.traits.OnOff
.
{ "requestId": "6894439706274654518", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OnOff", "params": { "on": true } } ] } ] } } ] }
{ "requestId": "6894439706274654518", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "on": true } } ] } }