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

action.devices.traits.OccupancySensing – התכונה הזו שייכת למכשירים שיכולים לזהות נוכחות באמצעות PIR, חיישן על-קולי או חישת מגע פיזית.

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

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

מאפיינים	סוג	תיאור
occupancySensorConfiguration	מערך	רשימה של אובייקטים. כל אחד מהם מכיל את סוג החיישן ואת העיכובים שמשויכים אליו וסף האירועים.
[item, ...]	מפגע	סוג החיישן, כולל העיכובים וסף האירועים שמשויכים אליו, אם רלוונטי.
occupancySensorType	String	חובה. ערכים נתמכים: PIR המכשיר תומך בחישת נוכחות באמצעות חיישן אינפרה-אדום פסיבי (PIR). ULTRASONIC המכשיר תומך בחישת נוכחות באמצעות חישה על-קולית. PHYSICAL_CONTACT במכשיר יש תמיכה בנוכחות באמצעות חיישן מגע פיזי.
occupiedToUnoccupiedDelaySec	Integer	מייצג את הזמן בשניות לפני שהאירוע הדווח משתנה למצב 'לא פנוי' אחרי האירוע האחרון שזוהה.
unoccupiedToOccupiedDelaySec	Integer	הערך הזה מייצג את הזמן בשניות שחולף לפני שהאירוע האחרון שזוהה כולל מצב תפוסה השתנה ל'לא פנוי' אחרי האירוע האחרון שזוהה. חובה אם המדיניות occupiedToUnoccupiedDelaySec מוגדרת.
unoccupiedToOccupiedEventThreshold	Integer	מספר אירועי הזיהוי שחייבים להתרחש בתקופה unoccupiedToOccupiedDelaySec לפני שהתפוסה מדווחת משתנה למצב 'לא משתתף'. חובה אם המדיניות unoccupiedToOccupiedDelaySec מוגדרת.

דוגמאות

חיישן תפוסה שתומך ב-PIR וב חישה על-קולית.

{
  "occupancySensorConfiguration": [
    {
      "occupancySensorType": "PIR",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    },
    {
      "occupancySensorType": "ULTRASONIC",
      "occupiedToUnoccupiedDelaySec": 10,
      "unoccupiedToOccupiedDelaySec": 10,
      "unoccupiedToOccupiedEventThreshold": 2
    }
  ]
}

מכשיר STATES

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

מדינות	סוג	תיאור
occupancy	String	חובה. התנאי מציין אם המכשיר מזהה נוכחות. ערכים נתמכים: OCCUPIED המכשיר מזהה נוכחות. UNOCCUPIED המכשיר לא מזהה נוכחות. UNKNOWN_OCCUPANCY_STATE מצב התפוסה הנוכחי שזוהה על ידי המכשיר לא ידוע.

דוגמאות

האם החיישן מזהה נוכחות במשרד?

{
  "occupancy": "OCCUPIED"
}

מכשיר COMMANDS

ללא.

מכשיר ERRORS

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