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

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

ATTRIBUTES للجهاز

يمكن أن تُبلغ الأجهزة التي تتضمّن هذه السمة عن ما يلي: كجزء من عملية 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"
}

CommandS للجهاز

قد تستجيب الأجهزة التي تتضمن هذه السمة لما يلي: الأوامر كجزء من عملية 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"
  }
}

أخطاء الجهاز

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