منزل مزوّد بأجهزة ذكية يؤدي إلى تبديل مخطط السمات
action.devices.traits.Toggles
: تنتمي هذه السمة إلى أي جهاز يتضمّن إعدادات لا تتوفّر إلا في إحدى حالتَين.
يمكن أن تمثل هذه الإعدادات زرًا فعليًا به حالة تشغيل/إيقاف أو حالة نشطة/غير نشطة، أو مربع اختيار في HTML، أو أي نوع آخر من العناصر التي تم تمكينها/تعطيلها على وجه التحديد. إذا كان الإعداد يتضمن أكثر من حالتين، أو له حالة لا يتم فيها تحديد أي من الخيارين الثنائيين، فإنه يتم تمثيله بشكل أفضل على أنه سمة الأوضاع، والتي تعادل الاتصالات متعددة الدول، أو أزرار الاختيار (الفعلية أو HTML)، أو الحالات الثنائية التي لم يتم تشغيلها/إيقافها بشكل صريح (على سبيل المثال، "AM/FM" أو "hot/cold").
تغطي هذه السمة مفتاح تبديل فرديًا واحدًا أو أكثر يمكن للمستخدمين ضبطه. بوجه عام، يجب استخدام مفاتيح التبديل هذه للوظائف التي تم إلغاء ربطها بسلوك الأجهزة الأخرى. يجب أن يستخدم السلوك المرتبط، مثل تشغيل الجهاز نفسه أو إيقافه،
سمات أكثر تحديدًا (على سبيل المثال، thermostatMode
في السمة TemperatureSetting).
الجهاز ATTRIBUTES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع إجراءات SYNC
، يُرجى الاطّلاع على تنفيذ الإجراء.
السمات | النوع | الوصف |
---|---|---|
availableToggles |
المصفوفة |
مطلوبة. قائمة بمفاتيح التبديل المتاحة. |
[item, ...] |
العنصر |
زر التبديل المتوفّر. |
name |
سلسلة |
مطلوبة. الاسم الداخلي لمفتاح التبديل الذي سيتم استخدامه في الأوامر والحالات. يمكن أن يكون هذا غير سهل الاستخدام، وستتم مشاركته عبر جميع اللغات. |
name_values |
المصفوفة |
مطلوبة. مرادفات زر التبديل بكل اللغات المعتمدة. |
[item, ...] |
العنصر |
مرادفات زر التبديل في لغة معينة. |
name_synonym |
المصفوفة |
مطلوبة. مرادفات التبديل. ويتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى بهذه اللغة. |
[item, ...] |
سلسلة |
اسم المرادفات. |
lang |
سلسلة |
مطلوبة. رمز اللغة (ISO 639-1). راجع اللغات المعتمدة. |
commandOnlyToggles |
منطقي |
(القيمة التلقائية: تشير إلى ما إذا كان الجهاز يتيح استخدام اتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز الرد على طلب QUERY أو حالة التقرير لهذه السمة. |
queryOnlyToggles |
منطقي |
(القيمة التلقائية: مطلوبة إذا كان الجهاز يوفر التنفيذ باستخدام طلب البحث فقط. تشير هذه السمة إلى إمكانية طلب الجهاز للحصول على معلومات الحالة فقط، ولا يمكن التحكّم فيها. |
أمثلة
جهاز يتضمن عدة مفاتيح تبديل
{ "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 }
حالة الجهاز STATES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات
التالية كجزء من عملية QUERY
. لمزيد من المعلومات حول التعامل مع إجراءات QUERY
، يُرجى الاطّلاع على تنفيذ الإجراء.
الولايات | النوع | الوصف |
---|---|---|
currentToggleSettings |
العنصر |
مطلوبة. زوج من المفتاح/القيمة مع تبديل |
<string> |
منطقي |
حالة التبديل الحالية. |
أمثلة
هل التعقيم مفعّل؟
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
مفاتيح COMMAND
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر
التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات حول التعامل مع إجراءات EXECUTE
، يُرجى الاطّلاع على تنفيذ الإجراء.
action.devices.commands.SetToggles
تعيين حالة تبديل معينة.
المَعلمات
المَعلمات | النوع | الوصف |
---|---|---|
updateToggleSettings |
العنصر |
مطلوبة. زوج المفتاح/القيمة مع تبديل |
<string> |
منطقي |
حالة تبديل جديدة |
أمثلة
تفعيل توفير الطاقة.
{ "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 aufPower Cool
en-US
-
activate
power freeze forthe freezer -
cancel
power cool forthe kitchen fridge
es-ES
-
pon el
enfriamiento rápido enla nevera -
quita el
enfriamiento rápido
fr-FR
-
mets le mode
power cool surle réfrigérateur -
Éteins le mode
power freeze duré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 opde koelkast -
zet
de koelkast opsuperkoelen
pt-BR
-
Ativa a função
power freeze nocongelador . -
Desativa o
bloqueio infantil doforno . -
desligar o
power cool dageladeira -
iniciar o modo
power freeze dofreezer
sv-SE
-
Stäng av
power cool ikylskåpet -
sätt på
power freeze påfrysen