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

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

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

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

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

מכשיר STATES

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

מדינות סוג תיאור
isFilled בוליאני

חובה.

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

currentFillLevel String

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

currentFillPercent מספר

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

דוגמאות

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

{
  "isFilled": true
}

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

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

COMMANDS של מכשיר

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

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"
  }
}

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

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

מכשיר ERRORS

כדאי לעיין ברשימה המלאה של שגיאות וחריגים.