مخطط سمات أوضاع المنزل المزوّد بأجهزة ذكية
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 |
منطقية |
(القيمة التلقائية: إذا تم ضبط هذا الإعداد على "صحيح"، سيتم تطبيق قواعد نحوية إضافية لمنطق الزيادة/الخفض، بترتيب (زيادة) صفيف الإعدادات. |
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 }
حالات الجهاز
قد تبلّغ الكيانات التي تتضمّن هذه السمة عن الحالات التالية كجزء من عملية QUERY
. لمزيد من المعلومات عن التعامل مع أغراض QUERY
، يُرجى الاطّلاع على تنفيذ النية.
الولايات | Type | الوصف |
---|---|---|
currentModeSettings |
كائن |
يجب ملء هذا الحقل. زوج المفتاح/القيمة مع الوضع |
<string> |
String |
|
أمثلة
ما هو وضع الجهاز؟
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
مفاتيح الجهاز
قد تستجيب الأجهزة التي تتضمّن هذه السمة إلى الأوامر التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات عن التعامل مع أغراض EXECUTE
، يُرجى الاطّلاع على تنفيذ النية.
action.devices.commands.SetModes
تعديل إعدادات الوضع
المَعلمات
المَعلمات | Type | الوصف |
---|---|---|
updateModeSettings |
كائن |
يجب ملء هذا الحقل. زوج المفتاح/القيمة مع الوضع |
<string> |
String |
|
أمثلة
الضبط على عملية تحميل كبيرة:
{ "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