طرحواره ویژگی ذخیره انرژی خانه هوشمند

action.devices.traits.EnergyStorage - این ویژگی متعلق به دستگاه‌هایی است که می‌توانند انرژی را در باتری ذخیره کنند و به طور بالقوه شارژ شوند، یا دستگاه‌هایی که می‌توانند دستگاه دیگری را شارژ کنند.

ویژگی‌های دستگاه

دستگاه‌هایی که این ویژگی را دارند، ممکن است ویژگی‌های زیر را به عنوان بخشی از عملیات SYNC گزارش دهند. برای کسب اطلاعات بیشتر در مورد مدیریت اهداف SYNC ، به بخش «تحقق اهداف» مراجعه کنید.

ویژگی‌ها نوع توضیحات
queryOnlyEnergyStorage بولی

الزامی است.

اگر این دستگاه فقط از پرس‌وجوهای مربوط به سطوح انرژی ذخیره‌شده و، به صورت اختیاری، وضعیت شارژ فعال (وابسته به ویژگی isRechargeable ) پشتیبانی کند، صحیح است، اما از شروع و توقف شارژ پشتیبانی نمی‌کند.

energyStorageDistanceUnitForUX رشته

(پیش‌فرض: "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 رشته

الزامی است.

توصیف کیفی از سطح ظرفیت انرژی. توجه داشته باشید که این برای زمانی است که داده‌های ظرفیت عددی وجود ندارد. اگر داده‌های ظرفیت عددی نیز موجود باشد، در صورت امکان، نسبت به داده‌های توصیفی ارجحیت خواهد داشت.

مقادیر پشتیبانی شده:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining آرایه

آرایه‌ای از جفت‌های واحد/مقدار که اطلاعات مربوط به ظرفیت انرژی فعلی دستگاه را در خود جای می‌دهند. برای مثال: <دستگاه> من در حال حاضر چند مایل مسافت را طی می‌کند یا <دستگاه> من چند درصد شارژ دارد

[ item, ... ] شیء

ظرفیت باقی مانده به صورت جفت واحد و مقدار.

rawValue عدد صحیح

الزامی است.

مقدار ظرفیت.

unit رشته

الزامی است.

واحد ظرفیت.

مقادیر پشتیبانی شده:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull آرایه

آرایه‌ای از جفت‌های واحد/مقدار که اطلاعات مربوط به ظرفیت تا زمان شارژ کامل دستگاه را در خود نگه می‌دارند. برای مثال: چقدر زمان تا شارژ کامل <device> باقی مانده است .

[ item, ... ] شیء

ظرفیت تا زمان شارژ.

rawValue عدد صحیح

الزامی است.

مقدار ظرفیت.

unit رشته

الزامی است.

واحد ظرفیت.

مقادیر پشتیبانی شده:

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 بولی

الزامی است.

برای شروع شارژ مقدار درست و برای توقف شارژ مقدار نادرست است.

مثال‌ها

دستور شروع شارژ

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

دستور توقف شارژ

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

خطاهای دستگاه

لیست کامل خطاها و استثنائات را مشاهده کنید.

deviceUnplugged : کاربر سعی کرده دستگاهی را که به برق وصل نیست، شارژ کند.