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

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 במכשיר

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