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

action.devices.traits.Modes: تشمل هذه السمة جميع الأوضاع المتاحة والإعدادات الخاصة بالأوضاع للجهاز.

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

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

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

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

سمات الجهاز

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

السمات	Type	الوصف
availableModes	صفيف	يجب ملء هذا الحقل. قائمة الأوضاع المتاحة
[item, ...]	كائن	الوضع المتاح:
name	String	يجب ملء هذا الحقل. الاسم الداخلي للوضع، والذي سيتم استخدامه في الأوامر والحالات. قد يكون هذا المحتوى غير سهل الاستخدام، وستتم مشاركته على جميع اللغات.
name_values	صفيف	يجب ملء هذا الحقل. مرادفات الوضع في كل لغة متوافقة.
[item, ...]	كائن	مرادفات الوضع في لغة معينة.
name_synonym	صفيف	يجب ملء هذا الحقل. مرادفات الوضع. يتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى في تلك اللغة.
[item, ...]	String	اسم المرادفات.
lang	String	يجب ملء هذا الحقل. رمز اللغة (ISO 639-1). اطّلِع على اللغات المتاحة.
settings	صفيف	يجب ملء هذا الحقل. الإعدادات المتوافقة مع هذا الوضع
[item, ...]	كائن	إعداد متوافق. يجب تضمين عنصرَين على الأقل.
setting_name	String	يجب ملء هذا الحقل. الاسم الداخلي لإعداد الوضع، والذي سيتم استخدامه في الأوامر والحالات. قد يكون هذا المحتوى غير سهل الاستخدام، وستتم مشاركته على جميع اللغات.
setting_values	صفيف	يجب ملء هذا الحقل. مرادفات الإعداد في كل لغة متاحة.
[item, ...]	كائن	مرادفات الإعدادات بلغة معيّنة.
setting_synonym	صفيف	يجب ملء هذا الحقل. مرادفات الإعداد. يتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى في تلك اللغة.
[item, ...]	String	اسم المرادفات.
lang	String	يجب ملء هذا الحقل. رمز اللغة (ISO 639-1). اطّلِع على اللغات المتاحة.
ordered	منطقية	(القيمة التلقائية: false) إذا تم ضبط هذا الإعداد على "صحيح"، سيتم تطبيق قواعد نحوية إضافية لمنطق الزيادة/الخفض، بترتيب (زيادة) صفيف الإعدادات.
commandOnlyModes	منطقية	(القيمة التلقائية: false) يشير إلى ما إذا كان الجهاز يتيح استخدام الاتصال أحادي الاتجاه (صحيح) أو اتصال ثنائي الاتجاه (خطأ). اضبُط هذه السمة على "صحيح" إذا لم يتمكن الجهاز من الاستجابة للغرض من QUERY أو "حالة التقرير" لهذه السمة.
queryOnlyModes	منطقية	(القيمة التلقائية: 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، يُرجى الاطّلاع على تنفيذ النية.

الولايات	Type	الوصف
currentModeSettings	كائن	يجب ملء هذا الحقل. زوج المفتاح/القيمة مع الوضع name للجهاز كمفتاح، القيمة الحالية setting_name كقيمة
<string>	String	setting_name حاليًا

أمثلة

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

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

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

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

action.devices.commands.SetModes

تعديل إعدادات الوضع

المَعلمات

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

أخطاء الجهاز

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