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

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

سمات الجهاز

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

السمات النوع الوصف
queryOnlyEnergyStorage Boolean

إنّ هذه السمة مطلوبة.

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

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

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

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

KILOMETERS
MILES
isRechargeable Boolean

(القيمة التلقائية: 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 Array

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

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

إنّ هذه السمة مطلوبة.

قيمة السعة
unit String

إنّ هذه السمة مطلوبة.

وحدة السعة

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

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
capacityUntilFull Array

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

السعة حتى يتم الشحن
rawValue Integer

إنّ هذه السمة مطلوبة.

قيمة السعة
unit String

إنّ هذه السمة مطلوبة.

وحدة السعة

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

SECONDS
MILES
KILOMETERS
PERCENTAGE
KILOWATT_HOURS
isCharging Boolean

ما إذا كان الجهاز قيد الشحن حاليًا
isPluggedIn Boolean

ما إذا كان الجهاز متصلاً بمصدر الطاقة حاليًا يمكن أن يكون الجهاز متصلاً بمصدر الطاقة، ولكن لا يتم شحنه بنشاط.

أمثلة

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

{
  "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 Boolean

إنّ هذه السمة مطلوبة.

يتم ضبط هذه السمة على "صحيح" لبدء الشحن، وعلى "خطأ" لإيقافه.

أمثلة

أمر بدء الشحن

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

أمر إيقاف الشحن

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

أخطاء الجهاز

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

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