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

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

מצבי המכשיר

ישויות עם התכונה הזו עשויות לדווח על הנושאים הבאים כחלק מהפעולה 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	בוליאני	חובה. נכון למילוי, לא נכון כדי להתרוקן.
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 במכשיר

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