סכימה של תכונת מצבי הבית החכם

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	בוליאני	(ברירת מחדל: false) אם המדיניות מקבלת את הערך true, דקדוק נוסף עבור לוגיקת הגדלה/הקטנה יחול, בסדר (הגדלה) של מערך ההגדרות.
commandOnlyModes	בוליאני	(ברירת מחדל: false) מציין אם המכשיר תומך בתקשורת חד-כיוונית (אמיתי) או דו-כיווני (לא נכון). מגדירים את המאפיין הזה כ-true אם המכשיר לא יכול להגיב לכוונת QUERY או למצב הדוח עבור התכונה הזו.
queryOnlyModes	בוליאני	(ברירת מחדל: false) חובה אם המכשיר תומך בביצוע שאילתות בלבד. מאפיין זה מציין אם ניתן לשלוח שאילתה לגבי המכשיר רק לגבי מידע על המדינה, ולא ניתן לשלוט בו.

דוגמאות

מכשיר עם כמה מצבים והגדרות.

{
  "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	אובייקט	חובה. זוג המפתח/ערך במצב name של המכשיר כמפתח, והsetting_name הנוכחי כערך.
<string>	מחרוזת	כרגע setting_name.

דוגמאות

באיזה מצב נמצא המכשיר?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

פקודות מכשיר

מכשירים עם התכונה הזו עשויים להגיב לפקודות הבאות, במסגרת הפעולה EXECUTE. מידע נוסף על טיפול ב-EXECUTE כוונות זמין בקטע מימוש כוונה.

action.devices.commands.SetModes

עדכון הגדרות המצב.

פרמטרים

פרמטרים	Type	תיאור
updateModeSettings	אובייקט	חובה. זוג המפתח/ערך במצב name של המכשיר כמפתח, והsetting_name החדש כערך.
<string>	מחרוזת	setting_name חדש.

דוגמאות

מוגדרת לטעינה גדולה.

{
  "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

ERRORS מכשיר

לצפייה ברשימה המלאה של השגיאות והחריגים