مخطط سمة الملء في الأجهزة الذكية

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

سمات الجهاز

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

السمات النوع الوصف
availableFillLevels كائن

يصف مستويات ملء الجهاز المختلفة.
levels مصفوفة

مطلوبة

قائمة بأسماء المستويات والمصطلحات المرادفة الخاصة بكل لغة
[item, ...] كائن

اسم المستوى والمصطلحات المرادفة الخاصة به بكل لغة
level_name String

مطلوبة

الاسم الداخلي للمستوى يمكن أن يكون هذا الاسم غير مناسب للمستخدمين، وسيتم مشاركته بين جميع اللغات.
level_values مصفوفة

مطلوبة

المصطلحات المرادفة للمستوى في كل لغة متوافقة
[item, ...] كائن

المصطلحات المرادفة للمستوى بلغة معيّنة يجب توفير عنصر واحد على الأقل بقيمة lang تساوي en لتوفير لغة احتياطية.
level_synonym مصفوفة

مطلوبة

المصطلح المرادف للمستوى يُستخدَم أول سلسلة في هذه القائمة كاسم أساسي للمستوى في تلك اللغة.
[item, ...] String

اسم المصطلح المرادف يجب توفير عنصر واحد على الأقل بقيمة lang تساوي en لتوفير لغة احتياطية.
lang String

مطلوبة

رمز اللغة (ISO 639-1) الاطّلاع على اللغات المتاحة.
ordered Boolean

مطلوبة

إذا كانت القيمة "صحيح"، يتعامل الجهاز مع قواعد نحوية إضافية لمنطق الزيادة أو النقصان، كما هو ممثّل في مصفوفة levels (على سبيل المثال، نصف المستوى).
supportsFillPercent Boolean

(الإعداد التلقائي: 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، يُرجى الاطّلاع على مقالة تنفيذ الأغراض.

الحالات النوع الوصف
isFilled Boolean

مطلوبة

تكون القيمة "صحيح" إذا كان الجهاز ممتلئًا بأي مستوى. تكون القيمة "خطأ" إذا تم تصريف الجهاز بالكامل.
currentFillLevel String

مطلوبة إذا تم ضبط السمة availableFillLevels تشير إلى level_name الحالي من السمة availableFillLevels الذي تم ملء الجهاز به.
currentFillPercent Number

مطلوبة إذا تم ضبط السمة supportsFillPercent تشير إلى النسبة المئوية الحالية لمستوى الملء

يجب أن تكون القيمة بين 0 و100.

أمثلة

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

{
  "isFilled": true
}

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

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

أوامر الجهاز

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

action.devices.commands.Fill

ملء الجهاز أو تصريفه

المعلمات

المعلمات النوع الوصف
fill Boolean

مطلوبة

تكون القيمة "صحيح" للملء و"خطأ" للتصريف.
fillLevel String

تشير إلى level_name من السمة availableFillLevels التي سيتم ضبطها. إذا لم يتم تحديدها، يتم الملء إلى المستوى التلقائي.
fillPercent Number

تشير إلى النسبة المئوية المطلوبة للمستوى

يجب أن تكون القيمة بين 0 و100.

أمثلة

املأ حوض الاستحمام.

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

أخطاء الجهاز

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