مخطط سمة EnergyStorage EnergyStorage Smart
action.devices.traits.EnergyStorage
: تنتمي هذه السمة إلى الأجهزة التي يمكنها تخزين الطاقة في بطارية ومن المحتمل أن تتم إعادة شحنها أو الأجهزة التي يمكنها شحن جهاز آخر.
الجهاز ATTRIBUTES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع إجراءات SYNC
، يُرجى الاطّلاع على تنفيذ الإجراء.
السمات | النوع | الوصف |
---|---|---|
queryOnlyEnergyStorage |
منطقي |
مطلوبة. صحيح إذا كان هذا الجهاز يتيح فقط طلبات البحث عن مستويات الطاقة المخزنة وحالة الشحن النشطة اختياريًا (بناءً على سمة |
energyStorageDistanceUnitForUX |
سلسلة |
(القيمة التلقائية: سيتم استخدامها في الردود على المستخدم. القيم المسموح بها:
|
isRechargeable |
منطقي |
(القيمة التلقائية: يمكنك ضبط القيمة على "true" إذا كان هذا الجهاز قابلاً لإعادة الشحن. يشير هذا إلى أنّ الجهاز يمكنه الإبلاغ عن حالة |
أمثلة
جهاز قابل لإعادة الشحن
{ "isRechargeable": true, "queryOnlyEnergyStorage": false }
جهاز قابل لإعادة الشحن يعرض مستوى الشحن الحالي بالأميال
{ "isRechargeable": true, "energyStorageDistanceUnitForUX": "MILES", "queryOnlyEnergyStorage": false }
جهاز غير قابل لإعادة الشحن يتيح فقط إعداد التقارير عن مستوى الشحن الحالي
{ "isRechargeable": false, "queryOnlyEnergyStorage": true }
حالة الجهاز STATES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات
التالية كجزء من عملية 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" }
مفاتيح COMMAND
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر
التالية كجزء من عملية 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
: حاول المستخدم شحن جهاز غير متصل بمصدر الطاقة.