مخطط ميزة 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"، سيعالج الجهاز قواعد نحوية إضافية لزيادة المنطق أو خفضه، كما هو موضح في مصفوفة |
supportsFillPercent |
منطقي |
(القيمة التلقائية: في حال التعيين على "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 |
سلسلة |
مطلوبة إذا تم ضبط سمة |
currentFillPercent |
Number |
مطلوبة إذا تم ضبط سمة |
أمثلة
هل حوض الاستحمام ممتلئ؟
{ "isFilled": true }
هل حوض الاستحمام ممتلئ؟ (مع المستويات).
{ "isFilled": true, "currentFillLevel": "half_level" }
مفاتيح COMMAND
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر
التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات حول التعامل مع إجراءات EXECUTE
، يُرجى الاطّلاع على تنفيذ الإجراء.
action.devices.commands.Fill
املأ الجهاز أو استنزفه.
المَعلمات
المَعلمات | النوع | الوصف |
---|---|---|
fill |
منطقي |
مطلوبة. True to fill, false to filter. |
fillLevel |
سلسلة |
للإشارة إلى |
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" } }