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

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

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

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

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

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

سمات الجهاز

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

السمات النوع الوصف
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 intents، اطّلِع على تلبية النية.

الولايات النوع الوصف
currentModeSettings العنصر

مطلوبة

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

setting_name حاليًا

أمثلة

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

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

أوامر الجهاز

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

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

أخطاء الجهاز

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