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

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

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

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

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

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

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

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

מאפיינים	סוג	תיאור
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 אם המכשיר לא יכול להגיב ל-Intent 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: מילוי Intent.

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

דוגמאות

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

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

CommandS במכשיר

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

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

ERRORS במכשיר

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