مخطط ميزة EnergyStorage Smart Home

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

سمات الجهاز

قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في 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. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في 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. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر 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: حاول المستخدم شحن جهاز غير متصل بالكهرباء.