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

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

ATTRIBUTES במכשיר

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

מאפיינים Type תיאור
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 כוונות זמין בקטע מימוש כוונה.

מדינות Type תיאור
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"
}

פקודות מכשיר

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