סכימת CameraPerson

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

sdm.devices.traits.CameraPerson

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

שדות

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

פקודות

אין פקודות בשביל המאפיין הזה.

אירועים

אדם

ניתן לעדכן 

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

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

אירוע שמעורב בו אדם

מטען ייעודי

{
  "eventId" : "2b16ac0a-6477-494e-b7e2-790ec1c46b85",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraPerson.Person" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "1rMqbtBm0jjUaUhN0aVfqj02vU...",
      }
    }
  }
  "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
דוגמה: "1rMqbtBm0jjUaUhN0aVfqj02vU...‎"

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

שדה תיאור סוג הנתונים
eventId המזהה הייחודי של האירוע. ‫string
דוגמה: "2b16ac0a-6477-494e-b7e2-790ec1c46b85"
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

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

שגיאות

יכול להיות שהמערכת תחזיר את קודי השגיאה הבאים שקשורים למאפיין הזה:

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

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