طرحواره ویژگی حالت های خانه هوشمند
action.devices.traits.Modes
- این ویژگی تمام حالت های موجود و تنظیمات خاص حالت را برای یک دستگاه پوشش می دهد.
این ویژگی به هر دستگاهی با تعداد دلخواه حالت "n-way" تعلق دارد که در آن حالت ها و تنظیمات برای هر حالت دلخواه و منحصر به هر دستگاه یا نوع دستگاه است. هر حالت دارای چندین تنظیمات ممکن است، اما تنها یکی را می توان در یک زمان انتخاب کرد. یک خشک کن نمی تواند به طور همزمان در حالت "ظریف"، "عادی" و "وظیفه سنگین" باشد. تنظیمی که به سادگی می تواند روشن یا خاموش شود به ویژگی Toggles تعلق دارد.
به عنوان مثال، ماشین لباسشویی می تواند تنظیماتی برای اندازه بار و دما داشته باشد. اینها هر دو حالت هستند زیرا مستقل از یکدیگر هستند، اما هر کدام می توانند در یک زمان فقط در یک حالت باشند. کاربر می تواند با دستوری مانند تنظیم دمای لباسشویی روی سرد، حالتی مانند دما را به صراحت تنظیم کند.
برخی از حالتها "مرتب" هستند و همچنین میتوان آنها را با حروف بالا/پایین، افزایش/کاهش تنظیم کرد. برای مثال، اندازه بار (کوچک، متوسط، بزرگ) و دما به وضوح مرتب شده است (توجه داشته باشید که دما مانند سایر دستگاهها یک ترموستات واقعی با هدف عددی نیست)، اما نوع بار (ظریف، معمولی، پشمی و غیره) ممکن است نباشد.
این ویژگی یک یا چند حالت فردی را پوشش می دهد که کاربران می توانند تنظیم کنند. به طور کلی، این حالتها باید برای عملکردی استفاده شوند که ارتباطی با سایر رفتار دستگاه ندارد. رفتار مرتبط، مانند روشن یا خاموش کردن خود دستگاه، باید از ویژگی های خاص تری استفاده کند (به عنوان مثال، حالت thermostatMode
در صفت TemperatureSetting ).
ویژگی های دستگاه
دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت SYNC
، به تحقق هدف مراجعه کنید.
ویژگی های | تایپ کنید | شرح |
---|---|---|
availableModes | آرایه | ضروری. لیست حالت های موجود |
[ item, ... ] | هدف - شی | حالت موجود |
name | رشته | ضروری. نام داخلی حالت، که در دستورات و حالت ها استفاده خواهد شد. این می تواند کاربر پسند نباشد و در همه زبان ها به اشتراک گذاشته شود. |
name_values | آرایه | ضروری. مترادف حالت در هر زبان پشتیبانی شده. |
[ item, ... ] | هدف - شی | مترادف حالت در یک زبان معین. |
name_synonym | آرایه | ضروری. مترادف حالت. اولین رشته در این لیست به عنوان نام متعارف سطح در آن زبان استفاده می شود. |
[ item, ... ] | رشته | نام مترادف. |
lang | رشته | ضروری. کد زبان (ISO 639-1). زبان های پشتیبانی شده را ببینید. |
settings | آرایه | ضروری. تنظیمات پشتیبانی شده برای این حالت |
[ item, ... ] | هدف - شی | تنظیم پشتیبانی شده حداقل به 2 مورد نیاز دارد. |
setting_name | رشته | ضروری. نام داخلی تنظیم حالت، که در دستورات و حالتها استفاده میشود. این می تواند کاربر پسند نباشد و در همه زبان ها به اشتراک گذاشته شود. |
setting_values | آرایه | ضروری. مترادف تنظیمات در هر زبان پشتیبانی شده. |
[ item, ... ] | هدف - شی | مترادف تنظیمات در یک زبان معین. |
setting_synonym | آرایه | ضروری. مترادف تنظیمات. اولین رشته در این لیست به عنوان نام متعارف سطح در آن زبان استفاده می شود. |
[ item, ... ] | رشته | نام مترادف. |
lang | رشته | ضروری. کد زبان (ISO 639-1). زبان های پشتیبانی شده را ببینید. |
ordered | بولی | (پیشفرض: اگر روی درست تنظیم شود، گرامر اضافی برای منطق افزایش/کاهش، به ترتیب (افزایش) آرایه تنظیمات اعمال خواهد شد. |
commandOnlyModes | بولی | (پیشفرض: نشان می دهد که آیا دستگاه از ارتباط یک طرفه (درست) یا دو طرفه (کاذب) پشتیبانی می کند. اگر دستگاه نمی تواند به یک هدف QUERY یا وضعیت گزارش برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید. |
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
، به تحقق هدف مراجعه کنید.
ایالت ها | تایپ کنید | شرح |
---|---|---|
currentModeSettings | هدف - شی | ضروری. کلید/مقدار با |
<string> | رشته | |
مثال ها
دستگاه در چه حالتی است؟
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
دستورات دستگاه
دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE
پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE
intent ها، به اجرای Intent مراجعه کنید.
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
سلام ورود
वैक्यूम परकार्पेट मोड लगाएं
it-IT
- imposta
l'aspirapolvere susilenzioso
ja-JP
掃除機 を静音 モードに設定して
ko-KR
세탁기 세탁량 많음 으로 설정해
pt-BR
- acionar a função
autolimpeza doaspirador - ligar o modo de
aquecimento