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

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

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

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

سمات الجهاز

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

أمثلة

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

{
  "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 intents، اطّلِع على تلبية النية.

أمثلة

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

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

أوامر الجهاز

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

action.devices.commands.SetToggles

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

المعلمات

أمثلة

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

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

أوقِف الفلتر.

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

نماذج الطلبات

أخطاء الجهاز