تبديل المنزل المزوّد بأجهزة ذكية إلى مخطط السمات
action.devices.traits.Toggles
: تنتمي هذه السمة إلى أيّ أجهزة تتضمّن إعدادات يمكن استخدامها في إحدى حالتَين فقط.
يمكن أن تمثل هذه الإعدادات زرًا فعليًا بالحالة "تفعيل/إيقاف" أو "نشط/غير نشط" أو مربّع اختيار في HTML أو أي نوع آخر من العناصر التي تم تفعيلها أو إيقافها على وجه التحديد. إذا كان الإعداد له أكثر من حالتَين، أو له حالة لا يتم فيها تحديد أي من الخيارين الثنائيين، يتم تمثيله بشكل أفضل كسمة الأوضاع، والتي تساوي الاتصالات المتعدّدة الحالات، أو أزرار الاختيار (الفعلية أو HTML)، أو الحالات الثنائية التي لا يتم تفعيلها/إيقافها بشكل صريح (على سبيل المثال، "AM/FM" أو "التشغيل السريع/البارد").
تشمل هذه السمة مفتاح تبديل فرديًا واحدًا أو أكثر يمكن للمستخدمين ضبطه. بشكل عام، يجب استخدام مفاتيح التبديل هذه في الوظائف التي تم إلغاء ربطها بسلوك الأجهزة الأخرى. ويجب أن يستخدم السلوك المرتبط، مثل تفعيل الجهاز نفسه
أو إيقافه، سمات أكثر تحديدًا (على سبيل المثال، thermostatMode
في سمة درجة الحرارة الخاصة بالسمة).
سمات الجهاز
قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات
التالية كجزء من عملية SYNC
. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في SYNC
، يُرجى الاطّلاع على تنفيذ النية بالشراء.
السمات | Type | الوصف |
---|---|---|
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 }
حالات الجهاز
قد تُبلِغ الكيانات التي تحمل هذه السمة عن الحالات التالية كجزء من عملية QUERY
. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY
، يُرجى الاطّلاع على تنفيذ النية بالشراء.
الولايات | Type | الوصف |
---|---|---|
currentToggleSettings |
العنصر |
مطلوب: زوج من المفتاح/القيمة مع مفتاح التبديل |
<string> |
منطقي |
حالة التبديل الحالية |
أمثلة
هل التعقيم مفعّل؟
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
حوالات الجهاز
قد تستجيب الأجهزة التي تستخدم هذه السمة للأوامر
التالية كجزء من عملية EXECUTE
. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في EXECUTE
، يُرجى الاطّلاع على تنفيذ النية بالشراء.
action.devices.commands.SetToggles
ضبط حالة تبديل معيّنة.
المعلّمات
المعلّمات | Type | الوصف |
---|---|---|
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 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