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

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 intent ها، به اجرای Intent مراجعه کنید.

action.devices.commands.Charge

شروع یا توقف شارژ.

این دستور به ویژگی های زیر نیاز دارد: 
{
  "isRechargeable": true
}

پارامترها

پارامترها تایپ کنید توضیحات
charge بولی

مورد نیاز.

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

نمونه ها

دستور شارژ را شروع کنید

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

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

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

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

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

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