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

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 מכשיר

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