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

action.devices.traits.Fill - התכונה הזו חלה על מכשירים שתומכים במילוי כמו אמבטיה.

ATTRIBUTES במכשיר

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

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

מתאר רמות שונות של מילוי המכשיר.

levels מערך

חובה.

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

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

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

level_name String

חובה.

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

level_values מערך

חובה.

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

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

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

level_synonym מערך

חובה.

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

[item, ...] String

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

lang String

חובה.

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

ordered בוליאני

חובה.

אם True, המכשיר מטפל בדקדוק נוסף עבור לוגיקת הגדלה או הקטנה, כפי שהיא מיוצגת על ידי מערך levels (לדוגמה, חצי רמה).

supportsFillPercent בוליאני

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

אם הערך הוא true, יש לאשר את הפקודות להתאמת הרמה לאחוז.

דוגמאות

מכשיר עם יכולות מילוי או ניקוז בסיסיים, שלא תומך ברמות מילוי נפרדות.

{}

מכשיר שתומך ברמות מילוי נפרדות.

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

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

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

מדינות Type תיאור
isFilled בוליאני

חובה.

הערך הוא True אם המכשיר מלא לרמה כלשהי. לא נכון אם המכשיר מתרוקן במלואו.

currentFillLevel String

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

currentFillPercent מספר

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

דוגמאות

האם האמבטיה מלאה?

{
  "isFilled": true
}

האם האמבטיה מלאה? (עם רמות).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

פקודות מכשיר

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

action.devices.commands.Fill

ממלאים את המכשיר או מרוקנים אותו.

פרמטרים

פרמטרים Type תיאור
fill בוליאני

חובה.

True to fill, false כדי לרוקן.

fillLevel String

מציין level_name מהמאפיין availableFillLevels להגדרה. אם לא צוין, ממלאים את רמת ברירת המחדל.

fillPercent מספר

מציין את אחוז הרמה המבוקשת.

דוגמאות

למלא את האמבטיה.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

ניקוזים את האמבטיה.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

למלא את האמבטיה האמצע.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

מגדילים את מפלס המילוי של האמבטיה באחת (צריך לציין את המאפיין ordered ל-true).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

ERRORS מכשיר

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