مخطط سمة مفاتيح التحكم في المنزل الذكي

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

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

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

سمات الجهاز

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

السمات النوع الوصف
availableToggles المصفوفة

مطلوبة

قائمة بأزرار التبديل المتاحة

[item, ...] الكائن

زر التبديل "متاح"

name String

مطلوبة

الاسم الداخلي لزر التبديل، والذي سيتم استخدامه في الأوامر والحالات قد لا يكون هذا الخيار سهل الاستخدام، وسيتم مشاركته بجميع اللغات.

name_values المصفوفة

مطلوبة

مرادفات زر التبديل في كل اللغات المتاحة

[item, ...] الكائن

مرادفات زر التبديل بلغة معيّنة يجب توفير عنصر واحد على الأقل بقيمة lang تساوي en من أجل توفير لغة احتياطية.

name_synonym المصفوفة

مطلوبة

مرادفات زر التبديل يُستخدَم السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى بهذه اللغة.

[item, ...] String

اسم المرادف يجب توفير عنصر واحد على الأقل بقيمة lang تساوي en من أجل توفير لغة احتياطية.

lang String

مطلوبة

رمز اللغة (ISO 639-1) اللغات المتاحة

commandOnlyToggles Boolean

(القيمة التلقائية: false)

توضّح ما إذا كان الجهاز يتيح استخدام الاتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا كان الجهاز لا يستجيب لطلب QUERY أو Report State لهذه السمة.

queryOnlyToggles Boolean

(القيمة التلقائية: 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> Boolean

حالة زر التبديل الحالية

أمثلة

هل ميزة التعقيم مفعَّلة؟

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

أوامر الجهاز

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

action.devices.commands.SetToggles

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

المعلمات

المعلمات النوع الوصف
updateToggleSettings الكائن

مطلوبة

زوج المفتاح/القيمة مع مفتاح التبديل name للجهاز كمفتاح، والحالة الجديدة كقيمة

<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 frysen

أخطاء الجهاز

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