مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

مخطط ميزة Smart Home Fill

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

الجهاز ATTRIBUTES

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

السمات النوع الوصف
availableFillLevels العنصر

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

levels المصفوفة

مطلوبة.

قائمة بأسماء المستويات والمرادفات بلغات محددة.

[item, ...] العنصر

اسم المستوى ومرادفاته الخاصة باللغة.

level_name سلسلة

مطلوبة.

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

level_values المصفوفة

مطلوبة.

مرادفات للمستوى في كل لغة مدعومة.

[item, ...] العنصر

مرادفات للمستوى بلغة معينة.

level_synonym المصفوفة

مطلوبة.

مرادف للمستوى. ويتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى بهذه اللغة.

[item, ...] سلسلة

اسم المرادفات.

lang سلسلة

مطلوبة.

رمز اللغة (ISO 639-1). راجع اللغات المعتمدة.

ordered منطقي

مطلوبة.

في حال التعيين على "true"، سيعالج الجهاز قواعد نحوية إضافية لزيادة المنطق أو خفضه، كما هو موضح في مصفوفة 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
  }
}

حالة الجهاز STATES

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

الولايات النوع الوصف
isFilled منطقي

مطلوبة.

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

currentFillLevel سلسلة

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

currentFillPercent Number

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

أمثلة

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

{
  "isFilled": true
}

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

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

مفاتيح COMMAND

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

action.devices.commands.Fill

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

المَعلمات

المَعلمات النوع الوصف
fill منطقي

مطلوبة.

True to fill, false to filter.

fillLevel سلسلة

للإشارة إلى 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"
  }
}

أخطاء الجهاز

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