مخطط سمات أوضاع المنزل الذكية
action.devices.traits.Modes
: تغطي هذه السمة جميع الأوضاع المتاحة والإعدادات الخاصة بالوضع في الجهاز.
تنتمي هذه السمة إلى أي أجهزة ذات عدد عشوائي من أوضاع "n-way" التي تكون فيها الأوضاع والإعدادات لكل وضع عشوائية ومميّزة لكل جهاز أو نوع جهاز. يحتوي كل وضع على إعدادات متعددة محتملة، ولكن يمكن اختيار إعداد واحد فقط في كل مرة، ولا يمكن استخدام النشّافة في الوضع "الناعم" و"العادي" و"المجهود الثقيل" في آنٍ واحد. أحد الإعدادات التي يمكن تفعيلها أو إيقافها ببساطة ينتمي إلى سمة Toggles.
على سبيل المثال، يمكن أن تحتوي الغسّالة على إعدادات لحجم الحمولة ودرجة حرارته. سيكون هذان الوضعان منفصلين لأنهما مستقلان عن بعضهما، ولكن يمكن أن يكون كل منهما في حالة واحدة فقط في كل مرة. يمكن للمستخدم ضبط وضع مثل درجة الحرارة بشكل صريح باستخدام أمر مثل ضبط حرارة الغسّالة على البرد.
تكون بعض الأوضاع "مرتبة" ويمكن ضبطها أيضًا باستخدام الإطالة أو النقصان، ما يؤدي إلى زيادة مستوى النطق أو خفضه. على سبيل المثال، يكون ترتيب التحميل (صغيرًا ومتوسطًا وكبيرًا) ودرجة الحرارة مرتبًا بشكل واضح (تجدر الإشارة إلى أنّ درجة الحرارة ليست حارسًا لدرجة الحرارة الفعلية بهدف رقمي، كما هو الحال على الأجهزة الأخرى)، ولكن قد لا يكون نوع التحميل (مواد رقيقة، عادية، صوفية، إلخ).
تغطي هذه السمة وضعًا فرديًا واحدًا أو أكثر يمكن للمستخدمين ضبطه. وبشكل عام، يجب استخدام هذه الأوضاع للوظائف التي تم إلغاء ربطها بسلوك الأجهزة الأخرى. يجب أن يستخدم السلوك المرتبط، مثل تشغيل الجهاز نفسه أو إيقاف تشغيله، سمات أكثر تحديدًا (على سبيل المثال، thermostatMode
في السمة TemperatureSetting).
الجهاز ATTRIBUTES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع إجراءات SYNC
، يُرجى الاطّلاع على تنفيذ الإجراء.
السمات | النوع | الوصف |
---|---|---|
availableModes |
المصفوفة |
مطلوبة. قائمة بالأوضاع المتاحة. |
[item, ...] |
العنصر |
الوضع المتاح. |
name |
سلسلة |
مطلوبة. الاسم الداخلي للوضع الذي سيتم استخدامه في الأوامر والحالات. يمكن أن يكون هذا غير سهل الاستخدام، وستتم مشاركته عبر جميع اللغات. |
name_values |
المصفوفة |
مطلوبة. مرادفات الوضع في كل اللغات المدعومة. |
[item, ...] |
العنصر |
مرادفات الوضع بلغة معينة. |
name_synonym |
المصفوفة |
مطلوبة. مرادفات الوضع. ويتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى بهذه اللغة. |
[item, ...] |
سلسلة |
اسم المرادفات. |
lang |
سلسلة |
مطلوبة. رمز اللغة (ISO 639-1). راجع اللغات المعتمدة. |
settings |
المصفوفة |
مطلوبة. الإعدادات المتوافقة لهذا الوضع. |
[item, ...] |
العنصر |
الإعداد المتوافق. يتطلب عنصرين على الأقل. |
setting_name |
سلسلة |
مطلوبة. الاسم الداخلي لإعداد الوضع، والذي سيتم استخدامه في الأوامر والحالات. يمكن أن يكون هذا غير سهل الاستخدام، وستتم مشاركته عبر جميع اللغات. |
setting_values |
المصفوفة |
مطلوبة. مرادفات الإعدادات بكل اللغات المعتمدة. |
[item, ...] |
العنصر |
مرادفات الإعداد بلغة معينة. |
setting_synonym |
المصفوفة |
مطلوبة. مرادفات الإعداد. ويتم استخدام السلسلة الأولى في هذه القائمة كاسم أساسي للمستوى بهذه اللغة. |
[item, ...] |
سلسلة |
اسم المرادفات. |
lang |
سلسلة |
مطلوبة. رمز اللغة (ISO 639-1). راجع اللغات المعتمدة. |
ordered |
منطقي |
(القيمة التلقائية: إذا تم ضبط هذه السياسة على "صحيح"، سيتم تطبيق قواعد إضافية لزيادة المنطق/تقليله، بالترتيب (يزيد) لمصفوفة الإعدادات. |
commandOnlyModes |
منطقي |
(القيمة التلقائية: تشير إلى ما إذا كان الجهاز يتيح استخدام اتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز الرد على طلب QUERY أو حالة التقرير لهذه السمة. |
queryOnlyModes |
منطقي |
(القيمة التلقائية: مطلوبة إذا كان الجهاز يوفر التنفيذ باستخدام طلب البحث فقط. تشير هذه السمة إلى إمكانية طلب الجهاز للحصول على معلومات الحالة فقط، ولا يمكن التحكّم فيها. |
أمثلة
الجهاز ذو الإعدادات والإعدادات المتعددة:
{ "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 }
حالة الجهاز STATES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات
التالية كجزء من عملية QUERY
. لمزيد من المعلومات حول التعامل مع إجراءات QUERY
، يُرجى الاطّلاع على تنفيذ الإجراء.
الولايات | النوع | الوصف |
---|---|---|
currentModeSettings |
العنصر |
مطلوبة. زوج المفتاح/القيمة مع وضع |
<string> |
سلسلة |
|
أمثلة
ما هو وضع الجهاز؟
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
مفاتيح COMMAND
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر
التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات حول التعامل مع إجراءات EXECUTE
، يُرجى الاطّلاع على تنفيذ الإجراء.
action.devices.commands.SetModes
تحديث إعدادات الوضع.
المَعلمات
المَعلمات | النوع | الوصف |
---|---|---|
updateModeSettings |
العنصر |
مطلوبة. إقران المفتاح/القيمة مع الوضع |
<string> |
سلسلة |
|
أمثلة
ضبط الفيديو على حِمل كبير
{ "command": "action.devices.commands.SetModes", "params": { "updateModeSettings": { "load_mode": "large_load" } } }
نماذج من الألفاظ
de-DE
-
Stelle
den Staubsauger aufRuhemodus
en-US
-
set
the vacuum toenergy saver mode
es-ES
-
pon
la lavadora en modofrío
fr-FR
-
mets
l'aspirateur ensilencieux
hi-IN
-
वैक्यूम परकार्पेट मोड लगाएं
it-IT
-
imposta
l'aspirapolvere susilenzioso
ja-JP
-
掃除機 を静音 モードに設定して
ko-KR
-
세탁기 세탁량 많음 으로 설정해
pt-BR
-
acionar a função
autolimpeza doaspirador -
ligar o modo de
aquecimento