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

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

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

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

מאפיינים	סוג	תיאור
availableFillLevels	אובייקט	מתאר את רמות המילוי השונות של המכשיר.
levels	מערך	חובה. רשימה של שמות רמות ומילים נרדפות ספציפיות לשפה.
[item, ...]	אובייקט	שם הרמה והמילים הנרדפות שלה בשפות שונות.
level_name	String	חובה. השם הפנימי של הרמה. ההגדרה הזו לא תמיד נוחה לשימוש, והיא משותפת לכל השפות.
level_values	מערך	חובה. מילים נרדפות לרמה בכל שפה נתמכת.
[item, ...]	אובייקט	מילים נרדפות לרמה בשפה נתונה. כדי לספק חלופה לשפה, צריך לפחות פריט אחד עם ערך lang של en.
level_synonym	מערך	חובה. מילה נרדפת לרמה. המחרוזת הראשונה ברשימה הזו משמשת כשם הקנוני של הרמה בשפה הזו.
[item, ...]	String	שם המילה הנרדפת. כדי לספק חלופה לשפה, צריך לפחות פריט אחד עם ערך lang של en.
lang	String	חובה. קוד שפה (ISO 639-1). כאן מפורטות השפות הנתמכות.
ordered	Boolean	חובה. אם הערך הוא true, המכשיר מטפל בדקדוק נוסף ללוגיקה של הגדלה או הקטנה, כפי שמיוצג על ידי המערך levels (לדוגמה, חצי רמה).
supportsFillPercent	Boolean	(ברירת מחדל: 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	Boolean	חובה. הערך הוא True אם המכשיר מלא בכל רמה. הערך הוא False אם הסוללה של המכשיר התרוקנה לגמרי.
currentFillLevel	String	חובה אם המאפיין availableFillLevels מוגדר. הערך הזה מציין את level_name הנוכחי מתוך מאפיין availableFillLevels שבו המכשיר מלא.
currentFillPercent	מספר	חובה אם המאפיין supportsFillPercent מוגדר. מציין את אחוז המילוי הנוכחי.

דוגמאות

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

{
  "isFilled": true
}

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

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

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

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

action.devices.commands.Fill

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

פרמטרים

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

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

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