סכימה של החלפת מצב לבית חכם
action.devices.traits.Toggles
- התכונה הזו שייכת למכשירים עם הגדרות שיכולות להתקיים רק באחד משני מצבים.
ההגדרות האלה יכולות לייצג לחצן פיזי עם מצב מופעל/כבוי או מצב פעיל/לא פעיל, תיבת סימון ב-HTML או כל סוג אחר של אלמנט שמופעל/מושבת באופן ספציפי. אם להגדרה יש יותר משני מצבים, או שיש בה מצב שבו לא נבחרה אף אחת מהאפשרויות הבינאריות, היא מיוצגת בצורה טובה יותר כתכונה של Modes, מקבילה לחיוגים ממספר מדינות, ללחצני בחירה (פיזית או HTML) או למצבים בינאריים שלא מופעלים/כבויים (לדוגמה, AM/FM) או "hot/cold".
תכונה זו מכסה החלפת מצב אחת או יותר שהמשתמשים יכולים להגדיר. באופן כללי, יש להשתמש במתגים האלה כדי לבטל את הקישור להתנהגות אחרת של המכשיר. ההתנהגות המקושרת, כמו הפעלת המכשיר עצמו או השבתתו, צריכה לכלול מאפיינים ספציפיים יותר (לדוגמה, thermostatMode
במאפיין הטמפרטורה).
ATTRIBUTES במכשיר
מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה של SYNC
. מידע נוסף על טיפול ב-SYNC
כוונות זמין בקטע מימוש כוונה.
מאפיינים | Type | תיאור |
---|---|---|
availableToggles |
מערך |
חובה. רשימה של מתגי הנגישות הזמינים. |
[item, ...] |
אובייקט |
מתג זמין. |
name |
מחרוזת |
חובה. השם הפנימי של לחצן החלפת המצב, שישמש בפקודות ובמצבים. הוא עשוי להיות לא ידידותי למשתמש ולשתף אותו בכל השפות. |
name_values |
מערך |
חובה. מילים נרדפות של המתג בכל השפות הנתמכות. |
[item, ...] |
אובייקט |
מילים נרדפות של לחצן החלפת המצב בשפה נתונה. |
name_synonym |
מערך |
חובה. מילים נרדפות של המתג. המחרוזת הראשונה ברשימה הזו משמשת כשם הקנוני של הרמה בשפה הזו. |
[item, ...] |
מחרוזת |
שם מילה נרדפת. |
lang |
מחרוזת |
חובה. קוד שפה (ISO 639-1). עיינו בשפות נתמכות. |
commandOnlyToggles |
בוליאני |
(ברירת מחדל: מציין אם המכשיר תומך בתקשורת חד-כיוונית (אמיתי) או דו-כיווני (לא נכון). מגדירים את המאפיין הזה כ-true אם המכשיר לא יכול להגיב לכוונת QUERY או למצב הדוח עבור התכונה הזו. |
queryOnlyToggles |
בוליאני |
(ברירת מחדל: חובה אם המכשיר תומך בביצוע שאילתות בלבד. מאפיין זה מציין אם ניתן לשלוח שאילתה לגבי המכשיר רק לגבי מידע על המדינה, ולא ניתן לשלוט בו. |
דוגמאות
מכשיר עם אפשרות להחלפת מצב.
{ "availableToggles": [ { "name": "sterilization_toggle", "name_values": [ { "name_synonym": [ "Clean", "Bio clean" ], "lang": "en" } ] }, { "name": "energysaving_toggle", "name_values": [ { "name_synonym": [ "Energy saving", "Eco" ], "lang": "en" } ] } ] }
מכשיר עם מתגי פקודות בלבד.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "commandOnlyToggles": true }
מכשיר עם מתגים רק לשאילתות.
{ "availableToggles": [ { "name": "filter_toggle", "name_values": [ { "name_synonym": [ "Filtered", "Filter" ], "lang": "en" } ] } ], "queryOnlyToggles": true }
מצבים של המכשיר
ישויות עם התכונה הזו עשויות לדווח על המצבים הבאים
במסגרת הפעולה QUERY
. מידע נוסף על טיפול ב-QUERY
כוונות זמין בקטע מימוש כוונה.
מדינות | Type | תיאור |
---|---|---|
currentToggleSettings |
אובייקט |
חובה. זוג מפתחות/ערך עם מתג החלפת המצב |
<string> |
בוליאני |
המצב הנוכחי של החלפת המצב. |
דוגמאות
האם עיקור מופעל?
{ "currentToggleSettings": { "sterilization_toggle": true, "energysaving_toggle": false } }
פקודות מכשיר
מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות, במסגרת הפעולה EXECUTE
. מידע נוסף על טיפול ב-EXECUTE
כוונות זמין בקטע מימוש כוונה.
action.devices.commands.SetToggles
להגדיר מצב לעבור.
פרמטרים
פרמטרים | Type | תיאור |
---|---|---|
updateToggleSettings |
אובייקט |
חובה. זוג מפתחות/ערך עם מתג החלפת המצב |
<string> |
בוליאני |
מצב החלפת מצב חדש |
דוגמאות
הפעלת החיסכון באנרגיה.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "energysaving_toggle": true } } }
השבתת המסנן.
{ "command": "action.devices.commands.SetToggles", "params": { "updateToggleSettings": { "filter_toggle": false } } }
דוגמאות להשמעות
de-DE
- Bitte schalte Power Cool am Kühlschrank aus
- stelle den Kühlschrank auf Power Cool
en-US
- activate power freeze for the freezer
- cancel power cool for the kitchen fridge
es-ES
- pon el enfriamiento rápido en la nevera
- quita el enfriamiento rápido
fr-FR
- mets le mode power cool sur le réfrigérateur
- Éteins le mode power freeze du réfrigérateur .
hi-IN
- रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
- रेफ़्रिजरेटर में पावर कूल मोड चालू करो
it-IT
- disattiva il power freeze del freezer
- imposta la funzione power freeze del surgelatore
ja-JP
- 冷蔵庫 の 急速冷凍 つけて
- 冷蔵庫 の 急速冷凍 を切ってくれる
ko-KR
- 냉장고 급속 냉장 해제해
- 냉장고 모드 급속 냉장 으로 바꿔
nl-NL
- Zet de power cool uit op de koelkast
- zet de koelkast op superkoelen
pt-BR
- Ativa a função power freeze no congelador .
- Desativa o bloqueio infantil do forno .
- desligar o power cool da geladeira
- iniciar o modo power freeze do freezer
sv-SE
- Stäng av power cool i kylskåpet
- sätt på power freeze på frysen