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

action.devices.traits.SensorState – תכונה זו מכסה גם מדידה כמותית וגם מצב איכותני.

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

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

מאפיינים	סוג	תיאור
sensorStatesSupported	מערך	חובה. כל אובייקט מייצג יכולות של מצב חיישן שנתמכות במכשיר הספציפי הזה. לכל חיישן צריכה להיות יכולת תיאורית או נומרית לפחות. החיישנים יכולים גם לדווח על שני סוגי הנתונים, ובמקרה כזה הערך המספרי יהיה מועדף.
[item, ...]	אובייקט	יכולות נתמכות של החיישנים. צריך להוסיף לפחות פריט אחד.
name	String	חובה. סוג חיישן נתמך. להצגת הטבלה 'חיישנים נתמכים'.
descriptiveCapabilities	אובייקט	תיאור יכולות החיישן.
availableStates	מערך	חובה. רשימת המצבים הזמינים למכשיר. המצב 'לא ידוע' נתמך באופן מרומז כשהחיישן לא מחזיר ערך.
[item, ...]	String	ערך נתמך של מצב תיאורי. צריך להוסיף לפחות פריט אחד.
numericCapabilities	אובייקט	מתאר את הערכים המספריים האפשריים שהחיישן יכול לדווח עליהם.
rawValueUnit	String	חובה. יחידה נומרית נתמכת.

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

דוגמאות

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

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

מכשיר חיישן שמדווח על ערך מספרי של מצב.

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

מכשיר חיישן שמדווח על ערך מצב תיאורי ומספרי.

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

חיישנים נתמכים

בטבלאות הבאות מפורטים סוגי החיישנים הנתמכים והיכולות שמשויכות אליהם.

איכות האוויר

שם	יכולות תיאוריות	יכולות מספריות
ערכים נתמכים: AirQuality	ערכים נתמכים: healthy moderate unhealthy unhealthy for sensitive groups very unhealthy hazardous good fair poor very poor severe unknown	ערכים נתמכים: AQI

פחמן חד-חמצני

שם	יכולות תיאוריות	יכולות מספריות
ערכים נתמכים: CarbonMonoxideLevel	ערכים נתמכים: carbon monoxide detected high no carbon monoxide detected unknown	ערכים נתמכים: PARTS_PER_MILLION

רמת העשן

שם	יכולות תיאוריות	יכולות מספריות
ערכים נתמכים: SmokeLevel	ערכים נתמכים: smoke detected high no smoke detected unknown	ערכים נתמכים: PARTS_PER_MILLION

רמת הניקיון של המסנן

שם	יכולות תיאוריות	יכולות מספריות
ערכים נתמכים: FilterCleanliness	ערכים נתמכים: clean dirty needs replacement unknown	ההודעה לא נתמכת.

נזילת מים

שם	יכולות תיאוריות	יכולות מספריות
ערכים נתמכים: WaterLeak	ערכים נתמכים: leak no leak unknown	ההודעה לא נתמכת.

זיהוי גשם

שם	יכולות תיאוריות	יכולות מספריות
ערכים נתמכים: RainDetection	ערכים נתמכים: rain detected no rain detected unknown	ההודעה לא נתמכת.

מצב המסנן

שם	יכולות תיאוריות	יכולות מספריות
ערכים נתמכים: FilterLifeTime	ערכים נתמכים: new good replace soon replace now unknown	ערכים נתמכים: PERCENTAGE

משך החיים של מסנן מחושב

שם	יכולות תיאוריות	יכולות מספריות
ערכים נתמכים: PreFilterLifeTime HEPAFilterLifeTime Max2FilterLifeTime	ההודעה לא נתמכת.	ערכים נתמכים: PERCENTAGE

רמת הפחמן הדו-חמצני

שם	יכולות תיאוריות	יכולות מספריות
ערכים נתמכים: CarbonDioxideLevel	ההודעה לא נתמכת.	ערכים נתמכים: PARTS_PER_MILLION

חומר חלקיקי

שם	יכולות תיאוריות	יכולות מספריות
ערכים נתמכים: PM2.5 PM10	ההודעה לא נתמכת.	ערכים נתמכים: MICROGRAMS_PER_CUBIC_METER

תרכובות אורגניות נדיפות

שם	יכולות תיאוריות	יכולות מספריות
ערכים נתמכים: VolatileOrganicCompounds	ההודעה לא נתמכת.	ערכים נתמכים: PARTS_PER_MILLION

מכשיר STATES

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

מדינות	סוג	תיאור
currentSensorStateData	מערך	חובה. רשימת מצבי החיישן הנוכחיים.
[item, ...]	אובייקט	מצב החיישן הנוכחי.
name	String	חובה. שם מצב החיישן. תואם לערך מ-sensorStatesSupported.
currentSensorState	String	הערך הנוכחי של המצב התיאורי. תואם לערך מ-sensorStatesSupported.
rawValue	מספר	הערך המספרי הנוכחי של החיישן.

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

דוגמאות

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

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

מכשיר חיישן שמדווח על ערך מספרי של מצב.

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

מכשיר חיישן שמדווח על ערך מצב תיאורי ומספרי.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

COMMANDS של מכשיר

ללא.

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

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

שדות	סוג	תיאור
SensorState	אובייקט	חובה. מטען ייעודי (payload) של התראות.
priority	Integer	חובה. רמת ההתראה. הערך הנתמך בשלב זה הוא 0, לציון ההודעה צריכה להיות מוקראת בקול.
name	String	חובה. שם מצב החיישן. הצגת רשימה של סוגי החיישנים הנתמכים להתראות.
currentSensorState	String	חובה. הערך הנוכחי של המצב התיאורי. הצגת רשימה של סוגי החיישנים הנתמכים להתראות.

המטען הייעודי של ההתראות יכול להכיל את סוגי החיישנים הבאים:

• AirQuality
• CarbonMonoxideLevel
• SmokeLevel
• FilterCleanliness
• WaterLeak
• RainDetection
• FilterLifeTime

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

דוגמאות

מזהה עשן.

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

מכשיר ERRORS

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