סכימה של CameraPerson

Nest Cam (מדור קודם) Nest Cam (לשימוש פנימי או פנימי, עם סוללה) Nest Cam with Floodlightlight Nest DoorbellNest DoorbellNest DoorbellNest DoorbellNest DoorbellNest Doorbellעם חיבור קווי

sdm.devices.traits.CameraPerson

התכונה הזו שייכת לכל מכשיר שתומך באירועי זיהוי אנשים.

שדות

אין שדות זמינים לתכונה הזו.

פקודות

אין פקודות זמינות לתכונה הזו.

אירועים

אדם

ניתן לעדכון 

המצלמה זיהתה אדם.

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

אירוע של אדם

מטען ייעודי (Payload)

{
  "eventId" : "d582ccc6-0de9-4cf3-a9ed-cc3b39218c97",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "M7S78ZiC4dTyGf_fPHczuRv26r...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

שדות אירועים של אנשים

שדה תיאור סוג הנתונים
eventSessionId Nest Doorbell (סוללה) Nest Doorbell (עם חיבור קווי) מזהה שניתן לאירועים שמתרחשים כחלק מסשן יחיד של אירועים קשורים. יכול לשמש לאיחוד אירועים.

צריך להשתמש בה כדי לשייך את האירוע הזה לאירוע ClipPreview שקשור ל-trait של CameraClipPreview.

 string
דוגמה: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId Nest Cam (מדור קודם) Nest Hub Max Nest Doorbell (מדור קודם) מזהה שמשויך לאירוע.

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

 string
דוגמה: "M7S78ZiC4dTyGf_fPHczuRv26r..."

שדות המטען הייעודי (payload) של אירועים

שדה תיאור סוג הנתונים
eventId המזהה הייחודי של האירוע. string
דוגמה: "d582ccc6-0de9-4cf3-a9ed-cc3b39218c97"
timestamp השעה שבה התרחש האירוע. string
לדוגמה: "2019-01-01T00:00:01Z"
resourceUpdate אובייקט עם פרטים על עדכון המשאב. object
userId מזהה ייחודי ומעורפל שמייצג את המשתמש. string
דוגמה: AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi'
eventThreadId ניתן לעדכון המזהה הייחודי של שרשור האירוע. string
דוגמה: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState ניתן לעדכון המצב של שרשור האירוע. string
ערכים: 'STARTED', 'UPDATED', 'ENDED'
resourceGroup אובייקט שמציין משאבים שעשויים לכלול עדכונים דומים לאירוע הזה. המשאב של האירוע עצמו (מהאובייקט resourceUpdate) תמיד יופיע באובייקט הזה. object

בקטע אירועים אפשר לקרוא מידע נוסף על סוגי האירועים השונים ועל אופן הפעולה שלהם.

שגיאות

ניתן להחזיר את קודי השגיאה הבאים ביחס לתכונה הזו:

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

הרשימה המלאה של קודי השגיאות ב-API זמינה בחומר העזר בנושא קוד שגיאה ב-API.