סכימת תכונות של EnergyStorage בבית חכם
action.devices.traits.EnergyStorage
– התכונה הזו שייכת למכשירים שאפשר לטעון באמצעותם אנרגיה מהסוללה, או שהם עשויים להיטען, או למכשירים שיכולים לטעון מכשיר אחר.
ATTRIBUTES במכשיר
מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה של SYNC
. מידע נוסף על טיפול ב-SYNC
כוונות זמין בקטע מימוש כוונה.
מאפיינים | Type | תיאור |
---|---|---|
queryOnlyEnergyStorage |
בוליאני |
חובה. הערך הוא True אם המכשיר תומך רק בשאילתות של רמות האנרגיה המאוחסנות, ובאופן אופציונלי גם במצב טעינה פעיל (בהתאם למאפיין |
energyStorageDistanceUnitForUX |
String |
(ברירת מחדל: ישמש בתגובה למשתמש. ערכים נתמכים:
|
isRechargeable |
בוליאני |
(ברירת מחדל: צריך להגדיר את הערך True אם המכשיר נטען. הגדרה זו מציינת שהמכשיר עשוי לדווח על המצב |
דוגמאות
מכשיר נטען
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
מכשיר נטען שמציג את רמת הטעינה הנוכחית במיילים
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
מכשיר שלא ניתן לטעינה אך תומך רק בדיווח על רמת החיוב הנוכחית
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
מצבים של המכשיר
ישויות עם התכונה הזו עשויות לדווח על המצבים הבאים
במסגרת הפעולה QUERY
. מידע נוסף על טיפול ב-QUERY
כוונות זמין בקטע מימוש כוונה.
מדינות | Type | תיאור |
---|---|---|
descriptiveCapacityRemaining |
String |
חובה. תיאור איכותי של רמת קיבולת האנרגיה. הערה: האפשרות הזו מיועדת למצבים שבהם אין נתוני קיבולת מספריים. אם יש גם נתונים זמינים לקיבולת מספרית, הם יקבלו עדיפות על פני תיאור כאשר ניתן. ערכים נתמכים:
|
capacityRemaining |
מערך |
מערך של צמדי יחידות/ערכים ששומרים מידע על קיבולת האנרגיה שיש כרגע למכשיר. לדוגמה: כמה מיילים יש ב-<device> שלי או באיזה אחוז יש להשתמש ב-<device> |
[item, ...] |
אובייקט |
הקיבולת שנותרה בצמד היחידה ובערך. |
rawValue |
Integer |
חובה. ערך הקיבולת. |
unit |
String |
חובה. יחידת הקיבולת. ערכים נתמכים:
|
capacityUntilFull |
מערך |
מערך של צמדי יחידות/ערכים שמחזיקים מידע על הקיבולת עד שהמכשיר טעון במלואו. לדוגמה: כמה זמן יחלוף עד ש-<device> ייטען באופן מלא. |
[item, ...] |
אובייקט |
קיבולת עד לטעינה. |
rawValue |
Integer |
חובה. ערך הקיבולת. |
unit |
String |
חובה. יחידת הקיבולת. ערכים נתמכים:
|
isCharging |
בוליאני |
האם המכשיר בטעינה כרגע. |
isPluggedIn |
בוליאני |
האם המכשיר מחובר כרגע. ניתן לחבר את המכשיר, אבל לא לטעון באופן פעיל. |
דוגמאות
מכשיר נטען
{ "descriptiveCapacityRemaining": "HIGH", "capacityRemaining": [ { "rawValue": 36000, "unit": "SECONDS" }, { "rawValue": 90, "unit": "PERCENTAGE" } ], "capacityUntilFull": [ { "rawValue": 120, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
מכשיר נטען שמציג את רמת הטעינה הנוכחית במיילים
{ "descriptiveCapacityRemaining": "CRITICALLY_LOW", "capacityRemaining": [ { "rawValue": 12, "unit": "MILES" } ], "capacityUntilFull": [ { "rawValue": 6000, "unit": "SECONDS" } ], "isCharging": true, "isPluggedIn": true }
מכשיר שאינו ניתן לטעינה ותומך בדיווח על רמת החיוב הנוכחית בלבד
{ "descriptiveCapacityRemaining": "LOW" }
פקודות מכשיר
מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות, במסגרת הפעולה EXECUTE
. מידע נוסף על טיפול ב-EXECUTE
כוונות זמין בקטע מימוש כוונה.
action.devices.commands.Charge
הפעלה או הפסקה של הטעינה.
פקודה זו מחייבת את המאפיינים הבאים:{ "isRechargeable": true }
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
charge |
בוליאני |
חובה. הערך True כדי להתחיל בטעינה. הערך False כדי להפסיק את הטעינה. |
דוגמאות
התחלת חיוב פקודה
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
הפסקת הפקודה
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
ERRORS מכשיר
לצפייה ברשימה המלאה של השגיאות והחריגיםdeviceUnplugged
: המשתמש ניסה לטעון מכשיר שלא מחובר.