הסכימה של מאפיין מילוי לבית חכם

action.devices.traits.Fill – המאפיין הזה רלוונטי למכשירים שתומכים במילוי, כמו אמבטיה.

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

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

מאפיינים	סוג	תיאור
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, ראו ביצוע כוונות.

מדינות	סוג	תיאור
isFilled	בוליאני	חובה. הערך true מוחזר אם המכשיר מלא בכל רמה. הערך False אם הסוללה של המכשיר ריקה לחלוטין.
currentFillLevel	String	חובה אם המאפיין availableFillLevels מוגדר. הערך הזה מציין את הערך הנוכחי של level_name מהמאפיין availableFillLevels שבו המכשיר מתמלא.
currentFillPercent	מספר	חובה אם המאפיין supportsFillPercent מוגדר. אחוז מילוי המלאי הנוכחי.

דוגמאות

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

{
  "isFilled": true
}

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

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

פקודות למכשיר

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

action.devices.commands.Fill

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

פרמטרים

פרמטרים	סוג	תיאור
fill	בוליאני	חובה. true למלא, 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"
  }
}

שגיאות במכשיר

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