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