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

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

ATTRIBUTES للجهاز

يمكن أن تُبلغ الأجهزة التي تتضمّن هذه السمة عن ما يلي: كجزء من عملية 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> في الوقت الحالي؟ لديها
[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"
}

CommandS للجهاز

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