סכימת תכונות מילוי לבית חכם
action.devices.traits.Fill
– התכונה הזו חלה על מכשירים שתומכים במילוי, כמו אמבטיה.
מאפייני המכשיר
מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה SYNC
. מידע נוסף על טיפול באובייקטים מסוג SYNC
זמין במאמר מילוי אובייקטים של Intent.
מאפיינים | סוג | תיאור |
---|---|---|
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 } }
מכשיר STATES
ישויות עם התכונה הזו עשויות לדווח על המצבים הבאים כחלק מהפעולה QUERY
. מידע נוסף על טיפול באובייקטים מסוג QUERY
זמין במאמר מילוי אובייקטים של Intent.
מדינות | סוג | תיאור |
---|---|---|
isFilled |
בוליאני |
חובה. הערך הוא True אם המכשיר מלא ברמה כלשהי. False אם המכשיר מרוקן במלואו. |
currentFillLevel |
String |
חובה אם המאפיין |
currentFillPercent |
מספר |
חובה אם המאפיין |
דוגמאות
האם האמבטיה מלאה?
{ "isFilled": true }
האמבטיה מלאה? (עם רמות).
{ "isFilled": true, "currentFillLevel": "half_level" }
COMMANDS של מכשיר
מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות כחלק מהפעולה EXECUTE
. מידע נוסף על טיפול באובייקטים מסוג EXECUTE
זמין במאמר מילוי אובייקטים של Intent.
action.devices.commands.Fill
ממלאים את המכשיר או מרוקנים אותו.
פרמטרים
פרמטרים | סוג | תיאור |
---|---|---|
fill |
בוליאני |
חובה. True למילוי, 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" } }
מגדילים את רמת המילוי של האמבטיה באחד (צריך להגדיר את הערך true
במאפיין ordered
).
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "full_level" } }