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

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

سمات الجهاز

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

السمات	Type	الوصف
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. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY، يُرجى الاطّلاع على تنفيذ النية بالشراء.

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

أمثلة

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

{
  "isFilled": true
}

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

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

حوالات الجهاز

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

action.devices.commands.Fill

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

المَعلمات

المَعلمات	Type	الوصف
fill	منطقي	مطلوب: على سبيل المثال، يتم ملء هذا الحقل، وعلى "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"
  }
}

أخطاء الجهاز

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