הסכימה של מאפיין המצבים בבית חכם

action.devices.traits.Modes – המאפיין הזה מכסה את כל המצבים הזמינים ואת ההגדרות הספציפיות למצבים במכשיר.

המאפיין הזה שייך לכל המכשירים עם מספר שרירותי של מצבים 'n-way', שבהם המצבים וההגדרות של כל מצב הם שרירותיים וייחודיים לכל מכשיר או סוג מכשיר. לכל מצב יש כמה הגדרות אפשריות, אבל אפשר לבחור רק אחת בכל פעם. אי אפשר להפעיל את המייבש במצב 'עדין', 'רגיל' ו'כבד' בו-זמנית. הגדרה שאפשר פשוט להפעיל או להשבית שייכת למאפיין Toggles.

לדוגמה, למכונת כביסה יכולות להיות הגדרות לגבי גודל המטען והטמפרטורה. שני המצבים האלה יהיו מצבים כי הם עצמאיים זה מזה, אבל כל אחד מהם יכול להיות במצב אחד בלבד בכל פעם. המשתמש יכול להגדיר מצב כמו טמפרטורה באופן מפורש באמצעות פקודה כמו Set the washer’s temperature to cold.

חלק מהמצבים 'ממוינים' וניתן גם לשנות אותם באמצעות לחיצה על 'הקודם'/'הבא', או על 'הגדלה'/'הקטנה' של הטקסט. לדוגמה, גודל הטעינה (קטן, בינוני, גדול) והטמפרטורה מסודרים בבירור (לתשומת ליבכם: הטמפרטורה היא לא תרמוסטט בפועל עם יעד מספרי, כמו במכשירים אחרים), אבל סוג הטעינה (כביסה עדינה, רגילה, צמר וכו') עשוי שלא להיות מסודר.

המאפיין הזה מכסה מצב אחד או יותר שמשתמשים יכולים להגדיר. באופן כללי, צריך להשתמש במצבים האלה לפונקציונליות שלא מקושרת להתנהגות אחרת של המכשיר. בהתנהגות מקושרת, כמו הפעלה או כיבוי של המכשיר עצמו, צריך להשתמש במאפיינים ספציפיים יותר (לדוגמה, thermostatMode במאפיין TemperatureSetting).

מאפייני המכשיר

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

מאפיינים סוג תיאור
availableModes מערך

חובה.

רשימה של המצבים הזמינים.
[item, ...] אובייקט

מצב זמין.
name String

חובה.

השם הפנימי של המצב, שישמש בפקודות ובמצבים. האפשרות הזו עשויה להיות לא ידידותית למשתמש, והיא תשותף בכל השפות.
name_values מערך

חובה.

שמות נרדפים של המצב בכל השפות הנתמכות.
[item, ...] אובייקט

שמות נרדפים של המצב בשפה נתונה.
name_synonym מערך

חובה.

מילים נרדפות של המצב. המחרוזת הראשונה ברשימה הזו משמשת כשם הקנוני של הרמה בשפה הזו.
[item, ...] String

שם המילה הנרדפת.
lang String

חובה.

קוד השפה (ISO 639-1). כאן מפורטות השפות הנתמכות.
settings מערך

חובה.

ההגדרות הנתמכות במצב הזה.
[item, ...] אובייקט

הגדרה נתמכת.

צריך לפחות 2 פריטים.
setting_name String

חובה.

השם הפנימי של הגדרת המצב, שישמש בפקודות ובמצבים. האפשרות הזו עשויה להיות לא ידידותית למשתמש, והיא תשותף בכל השפות.
setting_values מערך

חובה.

שמות נרדפים של ההגדרה בכל השפות הנתמכות.
[item, ...] אובייקט

מילים נרדפות של ההגדרה בשפה נתונה.
setting_synonym מערך

חובה.

מילים נרדפות של ההגדרה. המחרוזת הראשונה ברשימה הזו משמשת כשם הקנוני של הרמה בשפה הזו.
[item, ...] String

שם המילה הנרדפת.
lang String

חובה.

קוד השפה (ISO 639-1). כאן מפורטות השפות הנתמכות.
ordered בוליאני

(ברירת המחדל: false)

אם הערך של הפרמטר הזה מוגדר כ-true, תחול תחביר נוסף ללוגיקת העלייה/הירידה, לפי הסדר (הגדלה) של מערך ההגדרות.
commandOnlyModes בוליאני

(ברירת המחדל: false)

השדה הזה מציין אם המכשיר תומך בתקשורת חד-כיוונית (true) או דו-כיוונית (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, ראו ביצוע כוונות.

מדינות סוג תיאור
currentModeSettings אובייקט

חובה.

צמד מפתח/ערך שבו המצב name של המכשיר הוא המפתח, והערך הנוכחי setting_name הוא הערך.
<string> String

כרגע setting_name.

דוגמאות

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

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

פקודות למכשיר

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

action.devices.commands.SetModes

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

פרמטרים

פרמטרים סוג תיאור
updateModeSettings אובייקט

חובה.

צמד מפתח/ערך עם המצב name של המכשיר כמפתח, והערך החדש setting_name.
<string> 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

שגיאות במכשיר

הרשימה המלאה של השגיאות והחריגות