مخطط ميزة Smart Home Fill

action.devices.traits.Fill - تنطبق هذه السمة على الأجهزة المتوافقة مع الحشو مثل حوض الاستحمام.

الجهاز ATTRIBUTES

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

السمات	النوع	الوصف
availableFillLevels	العنصر	لوصف مستويات مختلفة من ملء الجهاز.
levels	المصفوفة	مطلوبة. قائمة بأسماء المستويات والمرادفات بلغات محددة.
[item, ...]	العنصر	اسم المستوى ومرادفاته الخاصة باللغة.
level_name	سلسلة	مطلوبة. الاسم الداخلي للمستوى. يمكن أن يكون هذا غير سهل الاستخدام، وستتم مشاركته عبر جميع اللغات.
level_values	المصفوفة	مطلوبة. مرادفات للمستوى في كل لغة مدعومة.
[item, ...]	العنصر	مرادفات للمستوى بلغة معينة.
level_synonym	المصفوفة	مطلوبة. مرادف للمستوى. ويتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى بهذه اللغة.
[item, ...]	سلسلة	اسم المرادفات.
lang	سلسلة	مطلوبة. رمز اللغة (ISO 639-1). راجع اللغات المعتمدة.
ordered	منطقي	مطلوبة. في حال التعيين على "true"، سيعالج الجهاز قواعد نحوية إضافية لزيادة المنطق أو خفضه، كما هو موضح في مصفوفة 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
  }
}

حالة الجهاز STATES

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

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

أمثلة

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

{
  "isFilled": true
}

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

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

مفاتيح COMMAND

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

action.devices.commands.Fill

املأ الجهاز أو استنزفه.

المَعلمات

المَعلمات	النوع	الوصف
fill	منطقي	مطلوبة. True to fill, false to filter.
fillLevel	سلسلة	للإشارة إلى 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"
  }
}

أخطاء الجهاز

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