סכימת מאפיינים של אחסון אנרגיה לבית חכם

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

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

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

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

מדינות סוג תיאור
descriptiveCapacityRemaining String

חובה.

תיאור איכותי של רמת קיבולת האנרגיה. הערה: זה קורה כשאין נתוני קיבולת מספריים. אם יש גם נתונים מספריים של הקיבולת, הם יהיו עדיפים על הנתונים התיאוריים, כשהדבר אפשרי.

ערכים נתמכים:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining מערך

מערך של צמדי יחידה/ערך שמכילים מידע על קיבולת האנרגיה הנוכחית של המכשיר. לדוגמה: כמה מיילים יש כרגע ב <device> שלי או מה אחוז הטעינה של <device> שלי
[item, ...] אובייקט

הקיבולת שנותרה בצמד של יחידה וערך.
rawValue Integer

חובה.

ערך הקיבולת.
unit String

חובה.

יחידת הקיבולת.

ערכים נתמכים:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull מערך

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

פרמטרים

פרמטרים סוג תיאור
charge בוליאני

חובה.

הערך True כדי להתחיל את הטעינה, הערך False כדי להפסיק את הטעינה.

דוגמאות

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

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

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

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

שגיאות במכשיר

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

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