مخطط سمة EnergyStorage للمنزل المزوّد بأجهزة ذكية

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

سمات الجهاز

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

السمات	Type	الوصف
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، يُرجى الاطّلاع على تنفيذ النية.

الولايات	Type	الوصف
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
}

المَعلمات

المَعلمات	Type	الوصف
charge	منطقية	يجب ملء هذا الحقل. اضغط على "true" لبدء الشحن، و"false" لإيقاف الشحن.

أمثلة

بدء طلب الشحن

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

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

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

أخطاء الجهاز

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

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