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

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

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

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

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

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

ATTRIBUTES للجهاز

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

السمات	النوع	الوصف
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 هدفًا. اطّلِع على تحقيق النية بالشراء:

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

أمثلة

ما هو الوضع المستخدَم على الجهاز؟

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

CommandS للجهاز

قد تستجيب الأجهزة التي تتضمن هذه السمة لما يلي: الأوامر كجزء من عملية 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

أخطاء الجهاز

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