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

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 منطقية

يجب ملء هذا الحقل.

إذا كانت القيمة 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
  }
}

حالات الجهاز

قد تبلّغ الكيانات التي تتضمّن هذه السمة عن الحالات التالية كجزء من عملية 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 منطقية

يجب ملء هذا الحقل.

اضغط على "true" للتعبئة، و"false" للاستنزاف.

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"
  }
}

أخطاء الجهاز

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