סכימה של תכונת מצבי הבית החכם
action.devices.traits.Modes
- תכונה זו מכסה את כל המצבים הזמינים וההגדרות הספציפיות של מכשיר.
התכונה הזו שייכת לכל מכשיר עם מספר שרירותי של מצבי "n-way", שבהם המצבים וההגדרות של כל מצב הם שרירותיים, ייחודיים לכל מכשיר או סוג מכשיר. בכל מצב אפשר לקבוע כמה הגדרות, אבל ניתן לבחור רק אחת בכל פעם, אבל מייבש המכונה לא יכול להיות במצב "אלגנטי", "רגיל" או "כבד". הגדרה שאפשר פשוט להפעיל או להשבית שייכת למאפיין Togles.
לדוגמה, למכונת כביסה יש הגדרות לגבי גודל האריזה והטמפרטורה. שני הסוגים יהיו מצבים, כי הם לא תלויים זה בזה, אבל הם יכולים להיות במצב אחד בלבד. המשתמש יכול להגדיר מצב כמו טמפרטורה באופן מפורש, באמצעות פקודה כמו Set the temperature’s temperature tocold.
חלק מהמצבים נמצאים 'בסדר', וניתן לשנות אותם באמצעות הגדלה/הקטנה, הגדלה או הקטנה של צריכת האנרגיה. לדוגמה: גודל העומס (קטן, בינוני, גדול) והטמפרטורה מסודרים בבירור (לתשומת ליבכם, הטמפרטורה היא לא תרמוסטט עם יעד מספרי, כמו במכשירים אחרים). עם זאת, סוג הטעינה (מעודן, רגיל, צמר וכו') לא בהכרח חל.
תכונה זו מכסה מצב אישי אחד או יותר שמשתמשים יכולים להגדיר. באופן כללי, כדאי להשתמש במצבים האלה כדי לבטל את הקישור לפעילות אחרת במכשירים. ההתנהגות המקושרת, כמו הפעלת המכשיר עצמו או השבתתו, צריכה לכלול מאפיינים ספציפיים יותר (לדוגמה, thermostatMode
בהגדרת הטמפרטורה).
ATTRIBUTES במכשיר
מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה של SYNC
. מידע נוסף על טיפול ב-SYNC
כוונות זמין בקטע מימוש כוונה.
מאפיינים | Type | תיאור |
---|---|---|
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 |
בוליאני |
(ברירת מחדל: אם המדיניות מקבלת את הערך true, דקדוק נוסף עבור לוגיקת הגדלה/הקטנה יחול, בסדר (הגדלה) של מערך ההגדרות. |
commandOnlyModes |
בוליאני |
(ברירת מחדל: מציין אם המכשיר תומך בתקשורת חד-כיוונית (אמיתי) או דו-כיווני (לא נכון). מגדירים את המאפיין הזה כ-true אם המכשיר לא יכול להגיב לכוונת 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> |
מחרוזת |
כרגע |
דוגמאות
באיזה מצב נמצא המכשיר?
{ "currentModeSettings": { "load_mode": "small_load", "temp_mode": "cold_temp" } }
פקודות מכשיר
מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות, במסגרת הפעולה EXECUTE
. מידע נוסף על טיפול ב-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