مخطط السمة في المنزل المزوّد بأجهزة ذكية

action.devices.traits.Toggles: تنتمي هذه السمة إلى أي أجهزة تتضمّن إعدادات لا يمكن أن تتوفّر إلّا في حالة واحدة أو حالتَين.

يمكن أن تمثل هذه الإعدادات زرًا فعليًا مع تشغيل/إيقاف أو نشط/غير نشط أو مربع اختيار في HTML أو أي نوع آخر من الخيارات المفعّلة/الموقوفة على وجه التحديد العنصر. إذا كان الإعداد يحتوي على أكثر من حالتَين أو كان في هذه الحالة لم يتم تحديد أي من الخيارين الثنائيين، فسيتم تمثيله بشكل أفضل Modes، التي تعادل الأرقام متعددة الدول، أزرار الاختيار (المادية أو HTML) أو الحالات الثنائية غير المستخدمة تشغيل/إيقاف (على سبيل المثال، "AM/FM" أو "ساخنة/بارد").

تغطي هذه السمة مفتاح تبديل فردي واحد أو أكثر يمكن للمستخدمين ضبطه. ضِمن عام، يجب استخدام مفاتيح التبديل هذه للوظائف غير المرتبطة من سلوك الجهاز الآخر. السلوك المرتبط، مثل تدوير الجهاز نفسه تفعيل أو إيقاف، يجب أن يستخدم سمات أكثر تحديدًا (على سبيل المثال، سمة thermostatMode في السمة TemperatureSetting).

ATTRIBUTES للجهاز

يمكن أن تُبلغ الأجهزة التي تتضمّن هذه السمة عن ما يلي: كجزء من عملية SYNC. للتعلّم مزيد من المعلومات عن التعامل مع SYNC هدفًا. اطّلِع على تحقيق النية بالشراء:

السمات	النوع	الوصف
availableToggles	مصفوفة	يجب ملء هذا الحقل. قائمة بمفاتيح التبديل المتاحة
[item, ...]	كائن	زر الإيقاف/التفعيل المتاح.
name	String	يجب ملء هذا الحقل. الاسم الداخلي لمفتاح التبديل الذي سيتم استخدامه في الأوامر والحالة وقد لا يكون هذا العنوان سهل الاستخدام، وستتم مشاركته بكل اللغات.
name_values	مصفوفة	يجب ملء هذا الحقل. مرادفات مفتاح التبديل في كل لغة متاحة.
[item, ...]	كائن	مرادفات مفتاح التبديل بلغة معينة.
name_synonym	مصفوفة	يجب ملء هذا الحقل. مرادفات مفتاح التبديل. يتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى في تلك اللغة.
[item, ...]	String	اسم مرادف.
lang	String	يجب ملء هذا الحقل. رمز اللغة (وفقًا لمعيار ISO 639-1) الاطّلاع على اللغات المتاحة
commandOnlyToggles	منطقي	(القيمة التلقائية: false) تشير هذه القيمة إلى ما إذا كان الجهاز يتيح استخدام الاتصال أحادي الاتجاه (صحيح) أو اتصال ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا لم يتمكن الجهاز من الاستجابة لطلب QUERY أو حالة الإبلاغ لهذه السمة.
queryOnlyToggles	منطقي	(القيمة التلقائية: false) تكون هذه السمة مطلوبة إذا كان الجهاز يتيح تنفيذ طلب البحث فقط. تشير هذه السمة إلى ما إذا كان يمكن الاستعلام عن الجهاز للحصول على معلومات الحالة فقط ولا يمكن التحكّم فيها.

أمثلة

الجهاز يتضمّن مفاتيح تبديل متعدّدة

{
  "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	كائن	يجب ملء هذا الحقل. زوج المفتاح/القيمة مع مفتاح تبديل name للجهاز كمفتاح، والحالة الحالية كقيمة.
<string>	منطقي	حالة التبديل الحالية

أمثلة

هل التعقيم مفعّل؟

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

CommandS للجهاز

قد تستجيب الأجهزة التي تتضمن هذه السمة لما يلي: الأوامر كجزء من عملية EXECUTE. للتعلّم مزيد من المعلومات عن التعامل مع EXECUTE هدفًا. اطّلِع على تحقيق النية بالشراء:

action.devices.commands.SetToggles

ضبط حالة تبديل معيّنة

المعلمات

المعلمات	النوع	الوصف
updateToggleSettings	كائن	يجب ملء هذا الحقل. زوج المفتاح/القيمة مع مفتاح تبديل name للجهاز كمفتاح، والحالة الجديدة كقيمة.
<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

أخطاء الجهاز

اطّلع على القائمة الكاملة الأخطاء والاستثناءات.