طرحواره ویژگی ذخیره انرژی خانه هوشمند
action.devices.traits.EnergyStorage
- این ویژگی متعلق به دستگاه هایی است که می توانند انرژی را در باتری ذخیره کرده و به طور بالقوه شارژ شوند، یا دستگاه هایی که می توانند دستگاه دیگری را شارژ کنند.
ویژگی های دستگاه
دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد SYNC
، به تحقق هدف مراجعه کنید.
صفات | تایپ کنید | توضیحات |
---|---|---|
queryOnlyEnergyStorage | بولی | مورد نیاز. درست است اگر این دستگاه فقط از درخواستهای مربوط به سطوح انرژی ذخیرهشده و، به صورت اختیاری، وضعیت شارژ فعال (وابسته به ویژگی |
energyStorageDistanceUnitForUX | رشته | (پیشفرض: در پاسخ به کاربر استفاده خواهد شد. مقادیر پشتیبانی شده:
|
isRechargeable | بولی | (پیشفرض: اگر این دستگاه قابل شارژ باشد روی true تنظیم کنید. این نشان میدهد که دستگاه ممکن است |
نمونه ها
دستگاه قابل شارژ
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
دستگاه قابل شارژی که میزان شارژ فعلی را بر حسب مایل نشان می دهد
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
دستگاه غیر قابل شارژ که فقط از گزارش سطح شارژ فعلی پشتیبانی می کند
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
وضعیت دستگاه
موجودیت های دارای این ویژگی ممکن است وضعیت های زیر را به عنوان بخشی از عملیات QUERY
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد QUERY
، به تحقق هدف مراجعه کنید.
ایالات | تایپ کنید | توضیحات |
---|---|---|
descriptiveCapacityRemaining | رشته | مورد نیاز. توصیف کیفی سطح ظرفیت انرژی توجه داشته باشید این برای زمانی است که هیچ داده ظرفیت عددی وجود ندارد. اگر دادههای ظرفیت عددی نیز موجود باشد، در صورت امکان بر توصیفی ترجیح داده میشود. مقادیر پشتیبانی شده:
|
capacityRemaining | آرایه | آرایهای از جفتهای واحد/مقدار که اطلاعاتی در مورد ظرفیت انرژی دستگاه در حال حاضر نگه میدارد. به عنوان مثال: در حال حاضر <device> من چند مایل دارد یا <device> من چند درصد شارژ دارد |
[ item, ... ] | شیء | ظرفیت باقیمانده در واحد و جفت ارزش. |
rawValue | عدد صحیح | مورد نیاز. مقدار ظرفیت |
unit | رشته | مورد نیاز. واحد ظرفیت مقادیر پشتیبانی شده:
|
capacityUntilFull | آرایه | آرایهای از جفتهای واحد/مقدار که اطلاعات مربوط به ظرفیت را تا زمانی که دستگاه کاملاً شارژ شود نگه میدارد. به عنوان مثال: چقدر زمان تا شارژ کامل <دستگاه> . |
[ item, ... ] | شیء | ظرفیت تا شارژ |
rawValue | عدد صحیح | مورد نیاز. مقدار ظرفیت |
unit | رشته | مورد نیاز. واحد ظرفیت مقادیر پشتیبانی شده:
|
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
: کاربر سعی کرد دستگاهی را شارژ کند که به برق متصل نیست.