مخطط سمة مفاتيح التحكم في المنزل الذكي
action.devices.traits.Toggles
: تنتمي هذه السمة إلى أي أجهزة تتضمّن إعدادات يمكن أن تكون في إحدى حالتين فقط.
يمكن أن تمثّل هذه الإعدادات زرًا ماديًا بحالة تشغيل/إيقاف أو نشط/غير نشط، أو مربّع اختيار في HTML، أو أي نوع آخر من العناصر التي يتم تفعيلها أو إيقافها بشكل محدّد. إذا كان للإعداد أكثر من حالتَين، أو كانت له حالة لم يتم فيها تحديد أي من الخيارَين الثنائيَين، من الأفضل تمثيله كسمة Modes، وهو ما يعادل أدوات التحكم المتعددة الحالات، أو أزرار الاختيار (المادية أو بتنسيق HTML)، أو الحالات الثنائية التي لا تكون صريحة كتشغيل/إيقاف (على سبيل المثال، "AM/FM" أو "ساخن/بارد").
تتضمّن هذه السمة مفتاح تحكّم واحدًا أو أكثر يمكن للمستخدمين ضبطه. بشكل عام، يجب استخدام مفاتيح التبديل هذه للوظائف غير المرتبطة بسلوك الجهاز الآخر. يجب استخدام سمات أكثر تحديدًا للسلوك المرتبط، مثل تشغيل الجهاز أو إيقافه (على سبيل المثال، thermostatMode
في السمة TemperatureSetting).
سمات الجهاز
قد تعرض الأجهزة التي تتضمّن هذه السمة السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع طلبات SYNC
، يمكنك الاطّلاع على مقالة تنفيذ الطلبات.
السمات | النوع | الوصف |
---|---|---|
availableToggles |
المصفوفة |
مطلوبة قائمة بأزرار التبديل المتاحة |
[item, ...] |
الكائن |
زر التبديل "متاح" |
name |
String |
مطلوبة الاسم الداخلي لزر التبديل، والذي سيتم استخدامه في الأوامر والحالات قد لا يكون هذا الخيار سهل الاستخدام، وسيتم مشاركته بجميع اللغات. |
name_values |
المصفوفة |
مطلوبة مرادفات زر التبديل في كل اللغات المتاحة |
[item, ...] |
الكائن |
مرادفات زر التبديل بلغة معيّنة يجب توفير عنصر واحد على الأقل بقيمة |
name_synonym |
المصفوفة |
مطلوبة مرادفات زر التبديل يُستخدَم السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى بهذه اللغة. |
[item, ...] |
String |
اسم المرادف يجب توفير عنصر واحد على الأقل بقيمة |
lang |
String |
مطلوبة رمز اللغة (ISO 639-1) اللغات المتاحة |
commandOnlyToggles |
Boolean |
(القيمة التلقائية: توضّح ما إذا كان الجهاز يتيح استخدام الاتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا كان الجهاز لا يستجيب لطلب QUERY أو Report State لهذه السمة. |
queryOnlyToggles |
Boolean |
(القيمة التلقائية: هذا الحقل مطلوب إذا كان الجهاز يتيح تنفيذ الطلبات فقط. تشير هذه السمة إلى ما إذا كان يمكن الاستعلام عن معلومات الحالة فقط للجهاز، ولا يمكن التحكّم فيه. |
أمثلة
جهاز مزوّد بمفاتيح تبديل متعددة
{ "availableToggles": [ { "name": "sterilization_toggle", "name_values": [ { "name_synonym": [ "Clean", "Bio clean" ], "lang": "en" } ] }, { "name": "energysaving_toggle", "name_values": [ { "name_synonym": [ "Energy saving", "Eco" ], "lang": "en" } ] } ] }
جهاز مزوّد بأزرار تبديل للتحكّم فقط
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
جهاز يتضمّن أزرار تبديل مخصّصة لطلبات البحث فقط
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
حالات الجهاز
يمكن أن تعرض الكيانات التي تتضمّن هذه السمة الحالات التالية كجزء من عملية QUERY
. لمزيد من المعلومات حول التعامل مع طلبات QUERY
، يمكنك الاطّلاع على مقالة تنفيذ الطلبات.
الولايات | النوع | الوصف |
---|---|---|
currentToggleSettings |
الكائن |
مطلوبة زوج المفتاح/القيمة الذي يتضمّن مفتاح التبديل |
<string> |
Boolean |
حالة زر التبديل الحالية |
أمثلة
هل ميزة التعقيم مفعَّلة؟
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
أوامر الجهاز
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات حول التعامل مع طلبات EXECUTE
، يمكنك الاطّلاع على مقالة تنفيذ الطلبات.
action.devices.commands.SetToggles
تحديد حالة تبديل معيّنة
المعلمات
المعلمات | النوع | الوصف |
---|---|---|
updateToggleSettings |
الكائن |
مطلوبة زوج المفتاح/القيمة مع مفتاح التبديل |
<string> |
Boolean |
حالة التبديل الجديدة |
أمثلة
فعِّل ميزة "توفير الطاقة".
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
إيقاف الفلتر:
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "filter_toggle": false } } }
عبارات نموذجية
de-DE
- Bitte schalte Power Cool am Kühlschrank aus
- stelle den Kühlschrank auf Power Cool
en-US
- activate power freeze for the freezer
- cancel power cool for the kitchen fridge
es-ES
- pon el enfriamiento rápido en la nevera
- quita el enfriamiento rápido
fr-FR
- mets le mode power cool sur le réfrigérateur
- Éteins le mode power freeze du réfrigérateur .
hi-IN
- रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
- रेफ़्रिजरेटर में पावर कूल मोड चालू करो
it-IT
- disattiva il power freeze del freezer
- imposta la funzione power freeze del surgelatore
ja-JP
- 冷蔵庫 の 急速冷凍 つけて
- 冷蔵庫 の 急速冷凍 を切ってくれる
ko-KR
- 냉장고 급속 냉장 해제해
- 냉장고 모드 급속 냉장 으로 바꿔
nl-NL
- Zet de power cool uit op de koelkast
- zet de koelkast op superkoelen
pt-BR
- Ativa a função power freeze no congelador .
- Desativa o bloqueio infantil do forno .
- desligar o power cool da geladeira
- iniciar o modo power freeze do freezer
sv-SE
- Stäng av power cool i kylskåpet
- sätt på power freeze på frysen