طرحواره ویژگی حالت های خانه هوشمند
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 auf Ruhemodus
en-US
- the vacuum to mode energy saver set
es-ES
- pon la lavadora en modo frío
fr-FR
- mets l'aspirateur en silencieux
سلام ورود
- वैक्यूम पर कार्पेट मोड लगाएं
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