סכימת איש מצלמה
Nest Cam (דור קודם)
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 (סוללה) אפשר להשתמש בה כדי לשייך את האירוע הזה לאירוע ClipPreview המשויך של תכונת CameraClipPreview. |
string דוגמה: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..." |
eventId |
Nest Cam (מדור קודם) אפשר להשתמש בו יחד עם הפקודה 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.