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

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

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

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

מאפיינים סוג תיאור
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, ראו ביצוע כוונות.

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

חובה.

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

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

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

דוגמאות

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

{
  "occupancy": "OCCUPIED"
}

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

ללא.

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

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