مخطط سمة تعبئة المنزل المزوّد بأجهزة ذكية

‫action.devices.traits.Fill: تنطبق هذه السمة على الأجهزة التي تتيح ملؤها، مثل حوض الاستحمام.

سمات الجهاز

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

السمات	النوع	الوصف
availableFillLevels	العنصر	يصف مستويات ملء الجهاز المختلفة.
levels	صفيف	مطلوبة قائمة بأسماء المستويات والمرادفات الخاصة بكل لغة
[item, ...]	كائن	اسم المستوى ومرادفاته الخاصة باللغة
level_name	String	يجب ملء هذا الحقل. الاسم الداخلي للمستوى. قد لا يكون هذا الإجراء سهل الاستخدام، وسيتمّت مشاركته بجميع اللغات.
level_values	مصفوفة	مطلوبة المرادفات للمستوى بكل لغة متاحة
[item, ...]	العنصر	مرادفات المستوى بلغة معيّنة.
level_synonym	صفيف	يجب ملء هذا الحقل. مرادف للمستوى يتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى في تلك اللغة.
[item, ...]	String	اسم مرادف.
lang	String	مطلوبة رمز اللغة (ISO 639-1) اطّلِع على اللغات المتاحة.
ordered	صحيح/خطأ	مطلوبة إذا كانت القيمة صحيحة، يعالج الجهاز قواعد نحوية إضافية لمنطق الزيادة أو النقصان، كما هو موضّح في صفيف levels (على سبيل المثال، نصف المستوى).
supportsFillPercent	منطقي	(القيمة التلقائية: false) في حال اختيار القيمة "true"، يمكنك قبول الأوامر لضبط المستوى على نسبة مئوية.

أمثلة

الجهاز الذي يتضمّن إمكانات أساسية لملء أو تفريغ البطارية ولا يتيح ضبط مستويات ملء منفصلة:

{}

جهاز يتيح ضبط مستويات الملء بشكل منفصل

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

حالات الجهاز

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

الولايات	النوع	الوصف
isFilled	صحيح/خطأ	مطلوبة صحيح إذا كان الجهاز ممتلئًا بأي مستوى. خطأ إذا كان الجهاز فارغًا تمامًا.
currentFillLevel	String	مطلوبة في حال ضبط السمة availableFillLevels. يشير إلى level_name الحالية من سمة availableFillLevels التي تم ملء الجهاز بها.
currentFillPercent	Number	مطلوبة في حال ضبط السمة supportsFillPercent. يشير إلى النسبة المئوية الحالية لمستوى التعبئة.

أمثلة

هل حوض الاستحمام ممتلئ؟

{
  "isFilled": true
}

هل حوض الاستحمام ممتلئ؟ (مع المستويات).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

أوامر الجهاز

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

action.devices.commands.Fill

املأ الجهاز أو صرِّفه.

المعلمات

المعلمات	النوع	الوصف
fill	صحيح/خطأ	مطلوبة صحيح لملء الخزان، وخطأ لتصريف المياه.
fillLevel	String	يشير إلى level_name من سمة availableFillLevels المطلوب ضبطها. في حال عدم تحديد قيمة، يتم ملء المساحة إلى المستوى التلقائي.
fillPercent	Number	تشير إلى النسبة المئوية للمستوى المطلوب.

أمثلة

املأ حوض الاستحمام.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

تصريف مياه حوض الاستحمام

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

املأ حوض الاستحمام حتى نصفه.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

زيادة مستوى ملء حوض الاستحمام بمقدار واحد (يجب أن تكون قيمة سمة ordered هي true).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

أخطاء الجهاز

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