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

action.devices.traits.Toggles – המאפיין הזה שייך לכל המכשירים עם הגדרות שיכולות להתקיים רק באחת משתי סטטוסים.

ההגדרות האלה יכולות לייצג לחצן פיזי במצב מופעל/מושבת או פעיל/לא פעיל, תיבת סימון ב-HTML או כל רכיב אחר שהופעל או הושבת באופן ספציפי. אם להגדרה יש יותר משני מצבים, או אם יש לה מצב שבו אף אחת מהאפשרויות הבינאריות לא מסומנת, עדיף לייצג אותה כמאפיין Modes, שזהה ללחצני בחירת תדרים עם כמה מצבים, לחצני בחירה (פיזיים או ב-HTML) או מצבים בינאריים שלא מוגדרים במפורש כמצב 'מופעל' או 'מושבת' (לדוגמה, 'AM/FM' או 'חם/קר').

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

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

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

דוגמאות

מכשיר עם כמה מתגים.

{
  "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, ראו ביצוע כוונות.

דוגמאות

האם העיקור מופעל?

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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

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

action.devices.commands.SetToggles

הגדרת מצב של מתג נתון.

פרמטרים

דוגמאות

מפעילים את מצב החיסכון באנרגיה.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

משביתים את המסנן.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

ביטויים לדוגמה

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