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

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, ראו מימוש של Intent.

מדינות	סוג	תיאור
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"
  }
}

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

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