הסכימה של מאפיין EnergyStorage לבית חכם

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 מערך

מערך של צמדי יחידה/ערך שמכילים מידע על הקיבולת עד שהמכשיר נטען במלואו. לדוגמה: How much time until <device> is fully charged.
[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, ראו מימוש של 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
  }
}

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

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

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