סכימת מאפיינים של מתגים לבית חכם

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

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

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

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

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

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

חובה.

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

המתג הזמין.
name String

חובה.

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

חובה.

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

מילים נרדפות למתג בשפה נתונה. כדי לספק חלופה לשפה, צריך לפחות פריט אחד עם ערך lang של en.
name_synonym מערך

חובה.

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

שם המילה הנרדפת. כדי לספק חלופה לשפה, צריך לפחות פריט אחד עם ערך lang של en.
lang String

חובה.

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

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

מציין אם המכשיר תומך בשימוש בתקשורת חד-כיוונית (true) או דו-כיוונית (false). מגדירים את המאפיין הזה ל-true אם המכשיר לא יכול להגיב לאינטנט QUERY או ל-Report State עבור התכונה הזו.
queryOnlyToggles Boolean

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

חובה אם המכשיר תומך בהרצה של שאילתות בלבד. המאפיין הזה מציין אם אפשר רק לשלוח שאילתה למכשיר כדי לקבל מידע על המצב שלו, ואי אפשר לשלוט בו.

דוגמאות

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

{
  "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 אובייקט

חובה.

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

הסטטוס הנוכחי של המתג.

דוגמאות

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

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

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

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

action.devices.commands.SetToggles

הגדרת מצב מסוים של מתג.

פרמטרים

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

חובה.

צמד מפתח/ערך עם המתג name של המכשיר כמפתח, והמצב החדש כערך.
<string> Boolean

מצב חדש של המתג

דוגמאות

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

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

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

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