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

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

أخطاء الجهاز

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