סכימת תכונות עבור הבית החכם

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

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

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

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

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

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

מצבי המכשיר

ישויות עם התכונה הזו עשויות לדווח על הנושאים הבאים כחלק מהפעולה 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 במכשיר

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