مخطط سمة ملء المنازل المزوّدة بأجهزة ذكية
action.devices.traits.Fill
: تنطبق هذه السمة على الأجهزة التي تتيح الملء، مثل أحواض الاستحمام.
سمات الجهاز
قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات عن التعامل مع أغراض SYNC
، يُرجى الاطّلاع على تنفيذ النية.
السمات | النوع | الوصف |
---|---|---|
availableFillLevels |
كائن |
يصف هذا المقياس المستويات المختلفة لملء الجهاز. |
levels |
صفيف |
يجب ملء هذا الحقل. قائمة بأسماء المستويات والمرادفات الخاصة بلغة معيّنة. |
[item, ...] |
كائن |
اسم المستوى ومرادفاته الخاصة باللغة. |
level_name |
String |
يجب ملء هذا الحقل. الاسم الداخلي للمستوى قد يكون هذا المحتوى غير سهل الاستخدام، وستتم مشاركته على جميع اللغات. |
level_values |
صفيف |
يجب ملء هذا الحقل. مرادفات المستوى في كل لغة متاحة. |
[item, ...] |
كائن |
مرادفات المستوى في لغة معينة. |
level_synonym |
صفيف |
يجب ملء هذا الحقل. مرادف المستوى. يتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى في تلك اللغة. |
[item, ...] |
String |
اسم المرادفات. |
lang |
String |
يجب ملء هذا الحقل. رمز اللغة (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 } }
حالات الجهاز
قد تبلّغ الكيانات التي تتضمّن هذه السمة عن الحالات التالية كجزء من عملية QUERY
. لمزيد من المعلومات عن التعامل مع أغراض QUERY
، يُرجى الاطّلاع على تنفيذ النية.
الولايات | النوع | الوصف |
---|---|---|
isFilled |
منطقية |
يجب ملء هذا الحقل. صحيح إذا تمت تعبئة الجهاز بأي مستوى. خطأ في حال نفاد الجهاز تمامًا. |
currentFillLevel |
String |
مطلوبة في حال ضبط السمة |
currentFillPercent |
Number |
مطلوبة في حال ضبط السمة |
أمثلة
هل حوض الاستحمام ممتلئ؟
{ "isFilled": true }
هل حوض الاستحمام ممتلئ؟ (مع المستويات).
{ "isFilled": true, "currentFillLevel": "half_level" }
مفاتيح الجهاز
قد تستجيب الأجهزة التي تتضمّن هذه السمة إلى الأوامر التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات عن التعامل مع أغراض EXECUTE
، يُرجى الاطّلاع على تنفيذ النية.
action.devices.commands.Fill
املأ الجهاز أو استنزفه.
المَعلمات
المَعلمات | النوع | الوصف |
---|---|---|
fill |
منطقية |
يجب ملء هذا الحقل. اضغط على "true" للتعبئة، و"false" للاستنزاف. |
fillLevel |
String |
تشير هذه السمة إلى |
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" } }