סכימת תכונה של מילוי לבית חכם
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 } }
מצבי המכשיר
ישויות עם התכונה הזו עשויות לדווח על הנושאים הבאים
כחלק מהפעולה 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 |
בוליאני |
חובה. נכון למילוי, לא נכון כדי להתרוקן. |
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" } }