مخطّط سمة EnergyStorage في المنزل الذكي

‫action.devices.traits.EnergyStorage: تنطبق هذه السمة على الأجهزة التي يمكنها تخزين الطاقة في بطارية وإعادة شحنها، أو الأجهزة التي يمكنها شحن جهاز آخر.

سمات الجهاز

قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC. للاطّلاع على مزيد من المعلومات عن معالجة أهداف SYNC، يمكنك الاطّلاع على تلبية الأهداف.

السمات النوع الوصف
queryOnlyEnergyStorage صحيح/خطأ

مطلوبة

صحيح إذا كان هذا الجهاز يتيح فقط طلبات البحث عن مستويات الطاقة المخزّنة، واختياريًا حالة الشحن النشط (تعتمد على سمة isRechargeable)، ولكن لا يتيح بدء الشحن وإيقافه.
energyStorageDistanceUnitForUX String

(القيمة التلقائية: "KILOMETERS")

سيتم استخدامها في الردود على المستخدم.

القيم المسموح بها:

KILOMETERS
MILES
isRechargeable منطقي

(القيمة التلقائية: false)

اضبط هذا الخيار على "صحيح" إذا كان هذا الجهاز قابلاً لإعادة الشحن. يشير ذلك إلى أنّ الجهاز قد يبلغ عن capacityUntilFull وisCharging وحالة isPluggedIn اختياريًا، ويمكنه قبول الأمر Charge.

أمثلة

جهاز قابل لإعادة الشحن

{
  "isRechargeable": true,
  "queryOnlyEnergyStorage": false
}

جهاز قابل لإعادة الشحن يعرض مستوى الشحن الحالي بالكيلومترات

{
  "isRechargeable": true,
  "energyStorageDistanceUnitForUX": "MILES",
  "queryOnlyEnergyStorage": false
}

جهاز غير قابل لإعادة الشحن لا يتيح سوى الإبلاغ عن مستوى الشحن الحالي

{
  "isRechargeable": false,
  "queryOnlyEnergyStorage": true
}

حالات الجهاز

يمكن للجهات التي تستخدم هذه السمة الإبلاغ عن الحالات التالية كجزء من عملية QUERY. للاطّلاع على مزيد من المعلومات عن معالجة أهداف QUERY، يمكنك الاطّلاع على تلبية الأهداف.

الولايات النوع الوصف
descriptiveCapacityRemaining String

يجب ملء هذا الحقل.

وصف نوعي لمستوى سعة الطاقة لاحظ أن هذا يحدث عندما لا تكون هناك بيانات سعة رقمية. إذا كانت بيانات السعة الرقمية متوفرة أيضًا، سيتم تفضيلها على البيانات الوصفية إن أمكن.

القيم المسموح بها:

CRITICALLY_LOW
LOW
MEDIUM
HIGH
FULL
capacityRemaining صفيف

مصفوفة من أزواج الوحدات/القيمة التي تحتوي على معلومات عن سعة الطاقة التي يحتفظ بها الجهاز حاليًا. على سبيل المثال: كم ميل قطعه <device> حاليًا أو ما هي النسبة المئوية لشحن <device>
[item, ...] كائن

السعة المتبقية في زوج القيمة والوحدة
rawValue عدد صحيح

يجب ملء هذا الحقل.

قيمة السعة
unit String

مطلوبة

وحدة السعة

القيم المسموح بها:

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull مصفوفة

صفيف من أزواج الوحدات/القيم التي تحتوي على معلومات عن السعة إلى أن يتم شحن الجهاز بالكامل على سبيل المثال: المدة المتبقية حتى يتم شحن <device> بالكامل.
[item, ...] العنصر

السعة إلى أن يتم الشحن
rawValue عدد صحيح

يجب ملء هذا الحقل.

قيمة السعة
unit String

مطلوبة

وحدة السعة

القيم المسموح بها:

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، يمكنك الاطّلاع على تلبية الأهداف.

action.devices.commands.Charge

عليك بدء الشحن أو إيقافه.

يتطلّب هذا الطلب السمات التالية: 
{
  "isRechargeable": true
}

المعلمات

المعلمات النوع الوصف
charge صحيح/خطأ

يجب ملء هذا الحقل.

صحيح لبدء الشحن، خطأ لإيقاف الشحن

أمثلة

بدء شحن الطلب

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

إيقاف شحن الطلب

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

أخطاء الجهاز

اطّلِع على القائمة الكاملة للأخطاء والاستثناءات.

deviceUnplugged: حاول المستخدم شحن جهاز غير متصل بمصدر طاقة.