مخطّط سمة الملء الذكي للمنزل

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

سمات الجهاز

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

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

أمثلة

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

{}

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

{
  "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 intents، اطّلِع على تلبية النية.

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

أمثلة

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

{
  "isFilled": true
}

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

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

أوامر الجهاز

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

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

أخطاء الجهاز

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