مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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