הסכימה CameraPerson

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" : "64d32b1b-c1fc-4c60-ab05-8f4858d9aeea",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "e2UB-0IXavhVh3hW5zQmlj55nK...",
      }
    }
  }
  "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
דוגמה: "e2UB-0IXavhVh3hW5zQmlj55nK…"

שדות של מטען נתונים אירועים

שדה תיאור סוג הנתונים
eventId המזהה הייחודי של האירוע. string
דוגמה: ‎64d32b1b-c1fc-4c60-ab05-8f4858d9aeea‎
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.