סכימת CameraEventImage
Nest Cam (מדור קודם)
sdm.devices.traits.CameraEventImage
התכונה הזו שייכת לכל מכשיר שתומך ביצירה של תמונות מאירועים.
שדות
אין שדות זמינים לתכונה הזו.
פקודות
GenerateImage
מספקת כתובת URL שממנה אפשר להוריד תמונה ממצלמה.
הפקודה הזו תומכת באירועים הבאים:
סוג | רכיב | תיאור |
---|---|---|
אירוע | אירוע Motion של תכונת CameraMotion | המצלמה זיהתה תנועה. |
אירוע | אירוע אדם בתכונת CameraMovie | המצלמה זיהתה אדם. |
אירוע | אירוע צליל של תכונת CameraSound | המצלמה זיהתה צליל. |
אירוע | אירוע Chime של תכונת DoorbellChime | פעמון הדלת נלחץ. |
eventId
של אירוע נתמך בבקשת הפקודה.
הבקשה והתגובה של GenerateImage
בקשה
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.CameraEventImage.GenerateImage
",
"params" : {
"eventId" : "4ydmwYgVf-F6f3bPO1dVBVnfKV..."
}
}
תשובה
{ "results" : { "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...", "token" : "g.0.eventToken" } }
שדות בקשה של GenerateImage
שדה | תיאור | סוג הנתונים |
---|---|---|
eventId |
מזהה האירוע שיש לבקש עבורו תמונת מצלמה קשורה. | string דוגמה: "4ydmwYgVf-F6f3bPO1dVBVnfKV..." |
שדות התגובה של GenerateImage
שדה | תיאור | סוג הנתונים |
---|---|---|
url |
כתובת ה-URL שממנה מורידים את תמונת המצלמה. | string דוגמה: "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..." |
token |
אסימון לשימוש בכותרת 'HTTP Authorization' כשמורידים את התמונה. | string דוגמה: "g.0.eventToken" |
הורדת תמונה ממצלמה
שולחים קריאה מסוג GET אל url
בתגובה לפקודה GenerateImage , באמצעות token
בכותרת ההרשאה של HTTP עם הרשאה בסיסית, כדי להוריד את התמונה מהמצלמה:
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...
להשתמש בפרמטרים של שאילתה width
או height
כדי להתאים אישית את הרזולוציה של
התמונה שהורדתם. צריך לציין רק אחד מהפרמטרים האלה. הפרמטר השני מותאם לעומס
באופן אוטומטי בהתאם ליחס הגובה-רוחב של המצלמה.
לדוגמה, אם יחס הגובה-רוחב של המצלמה הוא 4:3, כדי להוריד את התמונה מהמצלמה ברזולוציה 480 x 360, מציינים את הרוחב או את הגובה:
רוחב
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480
גובה
curl -H "Authorization: Basic g.0.eventToken" \
https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360
חלות הגבלות נוספות על כתובת ה-URL להורדה:
- אם מציינים את שני הפרמטרים בכתובת ה-URL, המערכת משתמשת ב-
width
וגם ב-height
המערכת מתעלמת ממנו. - אם אף אחד מהפרמטרים לא צוין בכתובת ה-URL, נבחר ערך ברירת מחדל של 480 בשביל
width
למידע על מאפייני התמונות, אפשר לעיין במאפיין CameraImage .
שגיאות
יכול להיות שיוחזר קודי השגיאה הבאים בקשר לתכונה הזו:
הודעת שגיאה | הכנסה לקליק | פתרון בעיות |
---|---|---|
תמונת המצלמה כבר לא זמינה להורדה. | DEADLINE_EXCEEDED |
התוקף של תמונות האירוע יפוג 30 שניות אחרי פרסום האירוע. חשוב להקפיד להוריד את התמונה לפני שהתוקף שלה יפוג. |
מזהה האירוע לא שייך למצלמה. | FAILED_PRECONDITION |
צריך להשתמש בeventID הנכון שהוחזר על ידי אירוע המצלמה. |
מידע נוסף זמין בחומר העזר בנושא קוד שגיאה של API את הרשימה המלאה של קודי השגיאה של ה-API.