مخطط ميزة EnergyStorage Smart Home
action.devices.traits.EnergyStorage
: تنتمي هذه السمة إلى الأجهزة التي يمكنها تخزين الطاقة في البطارية ومن المحتمل أن تتم إعادة شحنها أو الأجهزة التي يمكنها شحن جهاز آخر.
سمات الجهاز
قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات
التالية كجزء من عملية SYNC
. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في SYNC
، يُرجى الاطّلاع على تنفيذ النية بالشراء.
السمات | Type | الوصف |
---|---|---|
queryOnlyEnergyStorage |
منطقي |
مطلوب: صحيح إذا كان هذا الجهاز لا يتوافق إلا مع طلبات البحث حول مستويات الطاقة المخزَّنة وحالة الشحن النشطة (استنادًا إلى السمة |
energyStorageDistanceUnitForUX |
String |
(تلقائي: سيتم استخدامه في استجابات المستخدم. القيم المسموح بها:
|
isRechargeable |
منطقي |
(تلقائي: يمكنك ضبط القيمة على "صحيح" إذا كان هذا الجهاز قابلاً لإعادة الشحن. ويشير هذا إلى أنّ الجهاز قد يُبلِغ عن |
أمثلة
جهاز قابل لإعادة الشحن
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
جهاز قابل لإعادة الشحن يعرض مستوى الشحن الحالي بالأميال
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
جهاز غير قابل لإعادة الشحن متوافق مع إعداد تقارير عن مستوى الشحن الحالي فقط
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
حالات الجهاز
قد تُبلِغ الكيانات التي تحمل هذه السمة عن الحالات التالية كجزء من عملية QUERY
. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY
، يُرجى الاطّلاع على تنفيذ النية بالشراء.
الولايات | Type | الوصف |
---|---|---|
descriptiveCapacityRemaining |
String |
مطلوب: وصف نوعي لمستوى سعة الطاقة ويرجع ذلك إلى عدم توفّر بيانات السعة الرقمية. وفي حال توفُّر بيانات السعة الرقمية أيضًا، سيتم تفضيلها على البيانات الوصفية إن أمكن. القيم المسموح بها:
|
capacityRemaining |
مصفوفة |
مصفوفة من أزواج الوحدات/القيمة التي تحتفظ بمعلومات عن سعة الطاقة التي يخزّنها الجهاز حاليًا على سبيل المثال: كم يبلغ عدد الأميال الخاصة بي في <device> حاليًا أو ما هي النسبة المئوية لرسوم جهازي <device>؟ |
[item, ...] |
العنصر |
السعة المتبقية في الوحدة وزوج القيمة |
rawValue |
عدد صحيح |
مطلوب: قيمة السعة |
unit |
String |
مطلوب: وحدة السعة القيم المسموح بها:
|
capacityUntilFull |
مصفوفة |
مصفوفة من أزواج الوحدات/القيمة التي تلتقط المعلومات بالسعة حتى يتم شحن الجهاز بالكامل. على سبيل المثال: المدة المتبقية حتى يتم شحن <device> بالكامل. |
[item, ...] |
العنصر |
السعة حتى الساعة المخصّصة للشحن. |
rawValue |
عدد صحيح |
مطلوب: قيمة السعة |
unit |
String |
مطلوب: وحدة السعة القيم المسموح بها:
|
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
. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في EXECUTE
، يُرجى الاطّلاع على تنفيذ النية بالشراء.
action.devices.commands.Charge
ابدأ الشحن أو أوقِفه.
يتطلب هذا الأمر السمات التالية:{ "isRechargeable": true }
المَعلمات
المَعلمات | Type | الوصف |
---|---|---|
charge |
منطقي |
مطلوب: صحيح لبدء الشحن، على "خطأ" لإيقاف الشحن. |
أمثلة
بدء طلب الشحن
{ "command": "action.devices.commands.Charge", "params": { "charge": true } }
إيقاف طلب الشحن
{ "command": "action.devices.commands.Charge", "params": { "charge": false } }
أخطاء الجهاز
راجِع القائمة الكاملة للأخطاء والاستثناءات.deviceUnplugged
: حاول المستخدم شحن جهاز غير متصل بالكهرباء.