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

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

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

מכשירים עם התכונה הזו עשויים לדווח על הדברים הבאים כחלק מהפעולה SYNC. למידה מידע נוסף על טיפול בכוונות של 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
    }
  ]
}

מצבי המכשיר

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

מדינות סוג תיאור
occupancy String

חובה.

מציינת אם המכשיר מזהה נוכחות.

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

OCCUPIED
המכשיר מזהה נוכחות.
UNOCCUPIED
המכשיר לא מזהה נוכחות.
UNKNOWN_OCCUPANCY_STATE
מצב התפוסה הנוכחי שזוהה על ידי המכשיר לא ידוע.

דוגמאות

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

{
  "occupancy": "OCCUPIED"
}

CommandS במכשיר

ללא.

ERRORS במכשיר

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