סכימה של שיטות מילוי לבית חכם
action.devices.traits.Fill
- התכונה הזו חלה על מכשירים שתומכים במילוי כמו אמבטיה.
ATTRIBUTES במכשיר
מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה של SYNC
. מידע נוסף על טיפול ב-SYNC
כוונות זמין בקטע מימוש כוונה.
מאפיינים | Type | תיאור |
---|---|---|
availableFillLevels |
אובייקט |
מתאר רמות שונות של מילוי המכשיר. |
levels |
מערך |
חובה. רשימה של שמות רמות ומילים נרדפות ספציפיות לשפה. |
[item, ...] |
אובייקט |
שם הרמה ומילים נרדפות ספציפיות לשפה. |
level_name |
String |
חובה. השם הפנימי של הרמה. הוא עשוי להיות לא ידידותי למשתמש ולשתף אותו בכל השפות. |
level_values |
מערך |
חובה. מילים נרדפות של הרמה בכל שפה נתמכת. |
[item, ...] |
אובייקט |
מילים נרדפות של הרמה בשפה נתונה. |
level_synonym |
מערך |
חובה. מילה נרדפת של הרמה. המחרוזת הראשונה ברשימה הזו משמשת כשם הקנוני של הרמה בשפה הזו. |
[item, ...] |
String |
שם מילה נרדפת. |
lang |
String |
חובה. קוד שפה (ISO 639-1). עיינו בשפות נתמכות. |
ordered |
בוליאני |
חובה. אם True, המכשיר מטפל בדקדוק נוסף עבור לוגיקת הגדלה או הקטנה, כפי שהיא מיוצגת על ידי מערך |
supportsFillPercent |
בוליאני |
(ברירת מחדל: אם הערך הוא true, יש לאשר את הפקודות להתאמת הרמה לאחוז. |
דוגמאות
מכשיר עם יכולות מילוי או ניקוז בסיסיים, שלא תומך ברמות מילוי נפרדות.
{}
מכשיר שתומך ברמות מילוי נפרדות.
{ "availableFillLevels": { "levels": [ { "level_name": "half_level", "level_values": [ { "level_synonym": [ "Half", "Half way", "One half" ], "lang": "en" } ] }, { "level_name": "full_level", "level_values": [ { "level_synonym": [ "Full", "All the way", "Complete" ], "lang": "en" } ] } ], "ordered": true } }
מצבים של המכשיר
ישויות עם התכונה הזו עשויות לדווח על המצבים הבאים
במסגרת הפעולה QUERY
. מידע נוסף על טיפול ב-QUERY
כוונות זמין בקטע מימוש כוונה.
מדינות | Type | תיאור |
---|---|---|
isFilled |
בוליאני |
חובה. הערך הוא True אם המכשיר מלא לרמה כלשהי. לא נכון אם המכשיר מתרוקן במלואו. |
currentFillLevel |
String |
חובה אם המאפיין |
currentFillPercent |
מספר |
חובה אם המאפיין |
דוגמאות
האם האמבטיה מלאה?
{ "isFilled": true }
האם האמבטיה מלאה? (עם רמות).
{ "isFilled": true, "currentFillLevel": "half_level" }
פקודות מכשיר
מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות, במסגרת הפעולה EXECUTE
. מידע נוסף על טיפול ב-EXECUTE
כוונות זמין בקטע מימוש כוונה.
action.devices.commands.Fill
ממלאים את המכשיר או מרוקנים אותו.
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
fill |
בוליאני |
חובה. True to fill, false כדי לרוקן. |
fillLevel |
String |
מציין |
fillPercent |
מספר |
מציין את אחוז הרמה המבוקשת. |
דוגמאות
למלא את האמבטיה.
{ "command": "action.devices.commands.Fill", "params": { "fill": true } }
ניקוזים את האמבטיה.
{ "command": "action.devices.commands.Fill", "params": { "fill": false } }
למלא את האמבטיה האמצע.
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "half_level" } }
מגדילים את מפלס המילוי של האמבטיה באחת (צריך לציין את המאפיין ordered
ל-true
).
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "full_level" } }