مخطط سمة أوضاع المنزل الذكي

‫action.devices.traits.Modes: يغطي هذا النوع جميع الأوضاع المتاحة والإعدادات الخاصة بكل وضع لجهاز معيّن.

تنتمي هذه السمة إلى أي أجهزة تتضمّن عددًا عشوائيًا من أوضاع "n-way" التي تكون فيها الأوضاع والإعدادات لكل وضع عشوائية وفريدة لكل جهاز أو نوع جهاز. يتضمّن كل وضع إعدادات متعدّدة محتملة، ولكن يمكن اختيار إعداد واحد فقط في كل مرة، إذ لا يمكن أن يكون المجفّف في وضع "الملابس الرقيقة" و"الملابس العادية" و "الملابس الثقيلة" في الوقت نفسه. يجب تضمين الإعدادات التي يمكن تفعيلها أو إيقافها في السمة Toggles.

على سبيل المثال، يمكن أن تتضمّن الغسالة إعدادات لحجم الحمولة ودرجة الحرارة. سيكون كل منهما وضعًا لأنّهما مستقلان عن بعضهما البعض، ولكن يمكن أن يكون كل منهما في حالة واحدة فقط في المرة الواحدة. يمكن للمستخدم ضبط وضع مثل درجة الحرارة بشكل صريح باستخدام أمر مثل اضبط درجة حرارة الغسالة على باردة.

بعض الأوضاع "مرتّبة" ويمكن تعديلها أيضًا باستخدام عبارات "أعلى/أسفل" أو "زيادة/إنقاص". على سبيل المثال، يتم ترتيب حجم الحمولة (صغير، متوسط، كبير) ودرجة الحرارة بشكل واضح (يُرجى العِلم أنّ درجة الحرارة ليست ترموستات فعليًا مع هدف رقمي، كما هو الحال في الأجهزة الأخرى)، ولكن قد لا يتم ترتيب نوع الحمولة (ملابس رقيقة، عادية، صوف، إلخ).

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

سمات الجهاز

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

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

مطلوبة

قائمة الأوضاع المتاحة
[item, ...] الكائن

الوضع المتاح
name String

مطلوبة

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

مطلوبة

مرادفات الوضع في كل اللغات المتاحة
[item, ...] الكائن

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

مطلوبة

مرادفات الوضع. يُستخدَم السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى بهذه اللغة.
[item, ...] String

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

مطلوبة

رمز اللغة (ISO 639-1) اللغات المتاحة
settings المصفوفة

مطلوبة

الإعدادات المتوافقة مع هذا الوضع
[item, ...] الكائن

إعداد متوافق

يجب أن يحتوي على عنصرَين على الأقل.
setting_name String

مطلوبة

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

مطلوبة

مرادفات الإعداد بكل اللغات المتاحة
[item, ...] الكائن

مرادفات الإعداد بلغة معيّنة
setting_synonym المصفوفة

مطلوبة

مرادفات الإعداد يُستخدَم السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى بهذه اللغة.
[item, ...] String

اسم المرادف
lang String

مطلوبة

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

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

في حال ضبط هذا الخيار على "صحيح"، سيتم تطبيق قواعد نحوية إضافية لمنطق الزيادة/النقصان، وذلك بالترتيب (تصاعديًا) لمصفوفة الإعدادات.
commandOnlyModes Boolean

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

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

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

هذا الحقل مطلوب إذا كان الجهاز يتيح تنفيذ الطلبات فقط. تشير هذه السمة إلى ما إذا كان يمكن الاستعلام عن معلومات الحالة فقط للجهاز، ولا يمكن التحكّم فيه.

أمثلة

جهاز يتضمّن أوضاعًا وإعدادات متعددة

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

جهاز يتضمّن أوضاعًا مخصّصة للأوامر فقط

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

حالات الجهاز

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

الولايات النوع الوصف
currentModeSettings الكائن

مطلوبة

زوج المفتاح/القيمة الذي يتضمّن الوضع name للجهاز كمفتاح، والقيمة الحالية setting_name كقيمة
<string> String

setting_name حاليًا

أمثلة

ما هو وضع الجهاز؟

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

أوامر الجهاز

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

action.devices.commands.SetModes

عدِّل إعدادات الوضع.

المعلمات

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

مطلوبة

زوج المفتاح/القيمة الذي يتضمّن الوضع name للجهاز كمفتاح، والقيمة الجديدة setting_name كقيمة
<string> String

setting_name جديد

أمثلة

ضبط حجم الحمولة على كبير

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

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

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 を 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

أخطاء الجهاز

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