ברוכים הבאים למרכז המפתחים של Google Home. זהו היעד החדש ללימוד פיתוח פעולות לבית חכם. הערה:תצטרכו להמשיך ליצור פעולות במסוף הפעולות.

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

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

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

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

ATTRIBUTES במכשיר

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

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

חובה.

רשימה של מתגי הנגישות הזמינים.

[item, ...] אובייקט

מתג זמין.

name מחרוזת

חובה.

השם הפנימי של לחצן החלפת המצב, שישמש בפקודות ובמצבים. הוא עשוי להיות לא ידידותי למשתמש ולשתף אותו בכל השפות.

name_values מערך

חובה.

מילים נרדפות של המתג בכל השפות הנתמכות.

[item, ...] אובייקט

מילים נרדפות של לחצן החלפת המצב בשפה נתונה.

name_synonym מערך

חובה.

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

[item, ...] מחרוזת

שם מילה נרדפת.

lang מחרוזת

חובה.

קוד שפה (ISO 639-1). עיינו בשפות נתמכות.

commandOnlyToggles בוליאני

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

מציין אם המכשיר תומך בתקשורת חד-כיוונית (אמיתי) או דו-כיווני (לא נכון). מגדירים את המאפיין הזה כ-true אם המכשיר לא יכול להגיב לכוונת 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 כוונות זמין בקטע מימוש כוונה.

מדינות Type תיאור
currentToggleSettings אובייקט

חובה.

זוג מפתחות/ערך עם מתג החלפת המצב name של המכשיר בתור המפתח, והמצב הנוכחי כערך.

<string> בוליאני

המצב הנוכחי של החלפת המצב.

דוגמאות

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

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

פקודות מכשיר

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

action.devices.commands.SetToggles

להגדיר מצב לעבור.

פרמטרים

פרמטרים Type תיאור
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 frysen

ERRORS מכשיר

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