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

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

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

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

سمات الجهاز

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

أمثلة

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

{
  "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": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

أوامر الجهاز

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

action.devices.commands.SetToggles

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

المعلمات

أمثلة

فعِّل ميزة "توفير الطاقة".

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

إيقاف الفلتر:

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

عبارات نموذجية

أخطاء الجهاز