مخطط سمة EnergyStorage EnergyStorage Smart

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

الجهاز ATTRIBUTES

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

السمات	النوع	الوصف
queryOnlyEnergyStorage	منطقي	مطلوبة. صحيح إذا كان هذا الجهاز يتيح فقط طلبات البحث عن مستويات الطاقة المخزنة وحالة الشحن النشطة اختياريًا (بناءً على سمة isRechargeable)، ولكن لا يتيح بدء الشحن وإيقافه.
energyStorageDistanceUnitForUX	سلسلة	(القيمة التلقائية: "KILOMETERS") سيتم استخدامها في الردود على المستخدم. القيم المسموح بها: KILOMETERS MILES
isRechargeable	منطقي	(القيمة التلقائية: false) يمكنك ضبط القيمة على "true" إذا كان هذا الجهاز قابلاً لإعادة الشحن. يشير هذا إلى أنّ الجهاز يمكنه الإبلاغ عن حالة capacityUntilFull وisCharging وحالة isPluggedIn اختياريًا، ويمكنه قبول الأمر Charge.

أمثلة

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

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

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

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

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

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

حالة الجهاز STATES

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

الولايات	النوع	الوصف
descriptiveCapacityRemaining	سلسلة	مطلوبة. وصف نوعي لمستوى سعة الطاقة. يُرجى العِلم أنّ هذا الإجراء مخصّص عندما لا تتوفّر بيانات رقمية للسعة. إذا كانت بيانات السعة الرقمية متوفرة أيضًا، سيتم تفضيلها عن البيانات الوصفية إن أمكن. القيم المسموح بها: CRITICALLY_LOW LOW MEDIUM HIGH FULL
capacityRemaining	المصفوفة	مصفوفة من أزواج الوحدات/الوحدات التي تحمل معلومات عن سعة الطاقة التي يستوعبها الجهاز حاليًا. على سبيل المثال: كم يبلغ عدد الأميال التي يمتلكها جهازي حاليًا على <device> أو ما هي النسبة المئوية لرسوم جهاز <device> التي تم تحصيلها
[item, ...]	العنصر	السعة المتبقية في زوج الوحدة والقيمة
rawValue	عدد صحيح	مطلوبة. قيمة السعة.
unit	سلسلة	مطلوبة. وحدة السعة. القيم المسموح بها: SECONDS MILES KILOMETERS PERCENTAGE KILOWATT_HOURS
capacityUntilFull	المصفوفة	مصفوفة من أزواج الوحدات/الوحدات التي تحتفظ بمعلومات عن السعة حتى يتم شحن الجهاز بالكامل. على سبيل المثال: المدة المتبقية حتى اكتمال شحن الجهاز.
[item, ...]	العنصر	السعة حتى شحن البطارية.
rawValue	عدد صحيح	مطلوبة. قيمة السعة.
unit	سلسلة	مطلوبة. وحدة السعة. القيم المسموح بها: 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"
}

مفاتيح 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: حاول المستخدم شحن جهاز غير متصل بمصدر الطاقة.