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

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

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

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

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

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

מאפיינים	סוג	תיאור
availableToggles	מערך	חובה. רשימת המתגים הזמינים.
[item, ...]	אובייקט	מתג זמין.
name	String	חובה. שם פנימי של לחצן החלפת המצב, שישמש בפקודות ובמצבים. יכול להיות שלא יהיה ידידותי למשתמש, והוא ישותף בכל השפות.
name_values	מערך	חובה. מילים נרדפות למתג בכל השפות הנתמכות.
[item, ...]	אובייקט	מילים נרדפות למתג בשפה נתונה.
name_synonym	מערך	חובה. מילים נרדפות של המתג. המחרוזת הראשונה ברשימה הזו משמשת כשם הקנוני של הרמה בשפה הזו.
[item, ...]	String	שם מילה נרדפת.
lang	String	חובה. קוד שפה (ISO 639-1). כאן תוכלו לקרוא את השפות הנתמכות.
commandOnlyToggles	בוליאני	(ברירת המחדל: false) הערך הזה מציין אם המכשיר תומך בתקשורת חד-כיוונית (true) או בתקשורת דו-כיוונית (לא נכונה). יש להגדיר את המאפיין הזה כ-True אם המכשיר לא יכול להגיב ל-Intent QUERY או למצב דיווח של התכונה הזו.
queryOnlyToggles	בוליאני	(ברירת המחדל: 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
}

מכשיר STATES

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

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

דוגמאות

האם הסטריליזציה מופעלת?

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

COMMANDS של מכשיר

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

action.devices.commands.SetToggles

הגדרה של מצב החלפת מצב.

פרמטרים

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

דוגמאות

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

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

מכשיר ERRORS

כדאי לעיין ברשימה המלאה של שגיאות וחריגים.