סכימת איש מצלמה

Nest Cam (מדור קודם) Nest Cam (לשימוש פנימי וחיצוני, סוללה) Nest Cam with floodlight Nest Hubמכשיר פנים, רשת קווית

sdm.devices.traits.CameraPerson

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

שדות

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

פקודות

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

אירועים

אדם

עדכונים 

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

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

אירוע של אדם

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

{
  "eventId" : "3b0a2e71-9fb9-46f6-8410-0247f4b63f73",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "O5gk9PVpY-ViUXwaYf-4ENkEUS...",
      }
    }
  }
  "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 המשויך של תכונת CameraClipPreview.

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

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

 string
דוגמה: 'O5gk9PVpY-ViUXwaYf-4ENkEUS...'

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

שדה תיאור סוג הנתונים
eventId המזהה הייחודי של האירוע. string
דוגמה: "3b0a2e71-9fb9-46f6-8410-0247f4b63f73"
timestamp השעה שבה התרחש האירוע. string
לדוגמה: '2019-01-01T00:00:01Z'
resourceUpdate אובייקט שמכיל מידע על עדכון המשאב. object
userId מזהה ייחודי ומעורפל שמייצג את המשתמש. string
דוגמה: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId ניתן לעדכון המזהה הייחודי של השרשור של האירוע. string
דוגמה: 'd67cd3f7-86a7-425e-8b3-462f92ec9f59'
eventThreadState ניתן לעדכון מצב השרשור של האירוע. string
ערכים: "STARTED", "UPDATED", "ENDED"
resourceGroup אובייקט שמציין משאבים שייתכן שיש להם עדכונים דומים לאירוע הזה. המשאב של האירוע עצמו (מהאובייקט resourceUpdate) תמיד יופיע באובייקט הזה. object

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

שגיאות

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

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

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