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

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

action.devices.traits.Modes - תכונה זו מכסה את כל המצבים הזמינים וההגדרות הספציפיות של מכשיר.

התכונה הזו שייכת לכל מכשיר עם מספר שרירותי של מצבי "n-way", שבהם המצבים וההגדרות של כל מצב הם שרירותיים, ייחודיים לכל מכשיר או סוג מכשיר. בכל מצב אפשר לקבוע כמה הגדרות, אבל ניתן לבחור רק אחת בכל פעם, אבל מייבש המכונה לא יכול להיות במצב "אלגנטי", "רגיל" או "כבד". הגדרה שאפשר פשוט להפעיל או להשבית שייכת למאפיין Togles.

לדוגמה, למכונת כביסה יש הגדרות לגבי גודל האריזה והטמפרטורה. שני הסוגים יהיו מצבים, כי הם לא תלויים זה בזה, אבל הם יכולים להיות במצב אחד בלבד. המשתמש יכול להגדיר מצב כמו טמפרטורה באופן מפורש, באמצעות פקודה כמו Set the temperature’s temperature tocold.

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

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

ATTRIBUTES במכשיר

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

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

חובה.

רשימה של אמצעי התחבורה הזמינים.

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

מצב זמין.

name מחרוזת

חובה.

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

name_values מערך

חובה.

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

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

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

name_synonym מערך

חובה.

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

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

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

lang מחרוזת

חובה.

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

settings מערך

חובה.

הגדרות נתמכות למצב זה.

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

הגדרה נתמכת.

נדרשים לפחות 2 פריטים.

setting_name מחרוזת

חובה.

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

setting_values מערך

חובה.

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

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

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

setting_synonym מערך

חובה.

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

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

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

lang מחרוזת

חובה.

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

ordered בוליאני

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

אם המדיניות מקבלת את הערך true, דקדוק נוסף עבור לוגיקת הגדלה/הקטנה יחול, בסדר (הגדלה) של מערך ההגדרות.

commandOnlyModes בוליאני

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

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

queryOnlyModes בוליאני

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

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

דוגמאות

מכשיר עם כמה מצבים והגדרות.

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

מכשיר עם מצבי פקודה בלבד.

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

מצבים של המכשיר

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

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

חובה.

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

<string> מחרוזת

כרגע setting_name.

דוגמאות

באיזה מצב נמצא המכשיר?

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

פקודות מכשיר

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

action.devices.commands.SetModes

עדכון הגדרות המצב.

פרמטרים

פרמטרים Type תיאור
updateModeSettings אובייקט

חובה.

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

<string> מחרוזת

setting_name חדש.

דוגמאות

מוגדרת לטעינה גדולה.

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

דוגמאות להשמעות

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

ERRORS מכשיר

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