הסכימה של מאפיין Smart Home SensorState

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

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

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

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

מצבי המכשיר

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

מדינות סוג תיאור
currentSensorStateData מערך

חובה.

רשימת המצבים הנוכחיים של החיישנים.
[item, ...] אובייקט

המצב הנוכחי של החיישן.
name String

חובה.

שם מצב החיישן. תואם לערך מ-sensorStatesSupported.
currentSensorState String

הערך הנוכחי של המצב התיאורתי. תואם לערך מ-sensorStatesSupported.
rawValue מספר

הערך המספרי הנוכחי של החיישן.
alarmState String

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

ערכים נתמכים:

IDLE
האזעקה לא פועלת, הרמות שזוהו לא מסוכנות.
PRE_ALARM_1
רמות הזיהוי גבוהות אבל עדיין לא הגיעו לרמות חירום. ייתכן שהרמות יהיו מסוכנות בקרוב.
PRE_ALARM_2
אם המכשיר תומך במספר התראות לפני הגעה לרמות חירום, המשמעות היא שרמות הזיהוי גבוהות יותר מ-PRE_ALARM_1. הרמות ממשיכות לעלות ועשויות להתקרב לרמות חירום בקרוב.
ALARM
רמות הזיהוי הגיעו לרמות חירום והתקבלה התראה.
alarmSilenceState String

מציין את מצב ההשתקה של ההתראה של החיישן, כולל אם מותר כרגע להשתיק התראה פעילה. המצב הזה עשוי להופיע כשהמכשיר נמצא במצב של התראה מראש או במצב התראה. בגלאי עשן, לא נעשה שימוש בערכים ALLOWED ו-DISALLOWED. באפליקציית Google Home יש לוגיקה מובנית שמאפשרת לקבוע אם אפשר להשתיק אזעקה מהאפליקציה.

ערכים נתמכים:

ALLOWED
השעון המעורר לא מושתק וניתן להשבית אותו כרגע.
DISALLOWED
השעון המעורר לא מושתק ואי אפשר להשתיק אותו כרגע.
SILENCED
השעון המעורר הושתק.

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

דוגמאות

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

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

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

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

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

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

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

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

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

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200,
      "alarmState": "ALARM",
      "alarmSilenceState": "SILENCED"
    }
  ]
}

פקודות למכשיר

ללא.

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

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

שדות סוג תיאור
SensorState אובייקט

חובה.

מטען הייעודי (Payload) של ההתראה.
priority Integer

חובה.

מייצג את רמת ההתראה. הערך הנתמך כרגע הוא 0, והוא מציין שההתראה צריכה להיאמר בקול.
name String

חובה.

שם מצב החיישן. כאן אפשר למצוא רשימה של סוגי החיישנים הנתמכים לקבלת התראות.
currentSensorState String

חובה.

הערך הנוכחי של המצב התיאורתי. כאן אפשר למצוא רשימה של סוגי החיישנים הנתמכים לקבלת התראות.

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

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

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

דוגמאות

מזהה עשן.

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

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

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