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

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

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

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

سمات الجهاز

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

السمات	Type	الوصف
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، يُرجى الاطّلاع على تنفيذ النية.

الولايات	Type	الوصف
currentToggleSettings	كائن	يجب ملء هذا الحقل. زوج المفتاح/القيمة مع مفتاح التبديل name للجهاز كمفتاح، والحالة الحالية كقيمة
<string>	منطقية	حالة التبديل الحالية.

أمثلة

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

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

مفاتيح الجهاز

قد تستجيب الأجهزة التي تتضمّن هذه السمة إلى الأوامر التالية كجزء من عملية EXECUTE. لمزيد من المعلومات عن التعامل مع أغراض EXECUTE، يُرجى الاطّلاع على تنفيذ النية.

action.devices.commands.SetToggles

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

المَعلمات

المَعلمات	Type	الوصف
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

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.