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

Nest Cam‏ (דור קודם) Nest Cam‏ (לשימוש פנימי וחיצוני, עם סוללה) Nest Cam with floodlight‏ (עם זרקור) Nest Cam‏ (בתוך הבית, עם כבל) Nest Hub Max Nest Doorbell‏ (דור קודם) Nest Doorbell‏ (עם סוללה) Nest Doorbell‏ (עם כבל) 

sdm.devices.traits.CameraPerson

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

שדות

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

פקודות

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

אירועים

אדם

עדכון 

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

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

אירוע של אדם

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

{
  "eventId" : "914a826c-8b1f-4ff9-8b53-a2b92a945cd2",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "9Uk0BSbGbYySSeq4b4LOXni1fb...",
      }
    }
  }
  "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
דוגמה: "9Uk0BSbGbYySSeq4b4LOXni1fb..."

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

שדה תיאור סוג הנתונים
eventId המזהה הייחודי של האירוע. string
לדוגמה: '914a826c-8b1f-4ff9-8b53-a2b92a945cd2'
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.