סכימת תכונות EnergyStorage לבית חכם

action.devices.traits.EnergyStorage - התכונה הזו שייכת למכשירים שיכולים לאחסן אנרגיה בסוללה ואולי להיטען מחדש, או למכשירים שיכולים להטעין מכשיר אחר.

מאפייני המכשיר

מכשירים עם התכונה הזו עשויים לדווח על הדברים הבאים כחלק מהפעולה SYNC. למידה מידע נוסף על טיפול בכוונות של SYNC: מילוי Intent.

מאפיינים	סוג	תיאור
queryOnlyEnergyStorage	בוליאני	חובה. הערך הוא True אם המכשיר הזה תומך רק בשאילתות על רמות האנרגיה השמורות, ובאופן אופציונלי גם במצב טעינה פעיל (תלוי במאפיין isRechargeable), אבל הוא לא תומך בהפעלה והפסקה של הטעינה.
energyStorageDistanceUnitForUX	String	(ברירת המחדל: "KILOMETERS") ישמש בתשובות למשתמש. ערכים נתמכים: KILOMETERS MILES
isRechargeable	בוליאני	(ברירת המחדל: false) יש להגדיר את הערך True אם המכשיר נטען. זה אומר שהמכשיר עשוי לדווח על capacityUntilFull, על isCharging ועל מצב isPluggedIn (אופציונלי), ויכול לקבל את הפקודה Charge.

דוגמאות

מכשיר נטען

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

מכשיר נטען שבו מוצגת רמת הטעינה הנוכחית במיילים

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

מכשיר ללא טעינה שתומך רק בדיווח על רמת הטעינה הנוכחית

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

מצבי המכשיר

ישויות עם התכונה הזו עשויות לדווח על הנושאים הבאים כחלק מהפעולה QUERY. למידה מידע נוסף על טיפול בכוונות של QUERY: מילוי Intent.

מדינות	סוג	תיאור
descriptiveCapacityRemaining	String	חובה. תיאור איכותי של רמת קיבולת האנרגיה. לתשומת ליבכם: הערך הזה מיועד למצבים שבהם אין נתוני קיבולת מספריים. אם יש גם נתוני קיבולת מספריים, הם יקבלו עדיפות על פני תיאור כשהדבר יתאפשר. ערכים נתמכים: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	מערך	מערך של צמדי יחידה/ערך ששומרים מידע על קיבולת האנרגיה שיש במכשיר כרגע. לדוגמה: כמה מיילים נכללים במכשיר <device> שלי יש כרגע או מהו אחוז הטעינה של <device> שלי יש
[item, ...]	מפגע	הקיבולת שנותרה בצמד של יחידה וערך.
rawValue	Integer	חובה. ערך הקיבולת.
unit	String	חובה. יחידת הקיבולת. ערכים נתמכים: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	מערך	מערך של צמדי יחידה/ערך ששומרים מידע על הקיבולת של המכשיר עד שהוא טעון במלואו. לדוגמה: כמה זמן נותר עד <device> טעונה במלואה.
[item, ...]	מפגע	קיבולת עד לטעינה.
rawValue	Integer	חובה. ערך הקיבולת.
unit	String	חובה. יחידת הקיבולת. ערכים נתמכים: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
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"
}

CommandS במכשיר

מכשירים עם התכונה הזו עשויים להגיב לבקשות הבאות פקודות כחלק מהפעולה EXECUTE. למידה מידע נוסף על טיפול בכוונות של EXECUTE: מילוי Intent.

action.devices.commands.Charge

מתחילים או מפסיקים את הטעינה.

הפקודה הזו דורשת את המאפיינים הבאים:

{
  "isRechargeable": true
}

פרמטרים

פרמטרים	סוג	תיאור
charge	בוליאני	חובה. ערך True להתחלת הטעינה, False כדי להפסיק את הטעינה.

דוגמאות

הפעלת הפקודה לטעינה

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": true
  }
}

הפסקת הטעינה

{
  "command": "action.devices.commands.Charge",
  "params": {
    "charge": false
  }
}

ERRORS במכשיר

ראה את הרשימה המלאה של שגיאות וחריגים.

deviceUnplugged: המשתמש ניסה לטעון מכשיר שלא מחובר לחשמל.