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