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

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 : کاربر سعی کرد دستگاهی را شارژ کند که به برق متصل نیست.