סכימת CameraEventImage

Nest Cam (גרסה קודמת) Nest Hub Max Nest Doorbell (גרסה קודמת) 

sdm.devices.traits.CameraEventImage

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

שדות

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

פקודות

GenerateImage

כתובת URL להורדה של תמונה מהמצלמה.

הפקודה הזו תומכת באירועים הבאים:

סוג רכיב תיאור
אירוע אירוע Motion של מאפיין CameraMotion המצלמה זיהתה תנועה.
אירוע אירוע Person של מאפיין CameraPerson המצלמה זיהתה אדם.
אירוע אירוע Sound של מאפיין CameraSound המצלמה זיהתה קול.
אירוע אירוע Chime של מאפיין DoorbellChime הופעל פעמון הדלת.
כדי לקבל כתובת URL להורדה של תמונה מהמצלמה שקשורה לאירוע נתמך, משתמשים ב-eventId בבקשת הפקודה.

בקשה ותגובה של GenerateImage

בקשה

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "dyzd3udskfFz-8OXQehXB41Peh..."
  }
}

תשובה

{
  "results" : {
    "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "token" : "g.0.eventToken"
  }
}

שדות של בקשת GenerateImage

שדה תיאור סוג הנתונים
eventId מזהה האירוע שעבורו רוצים לבקש תמונה קשורה מהמצלמה. ‫string
דוגמה: "dyzd3udskfFz-8OXQehXB41Peh..."

שדות בתשובה של GenerateImage

שדה תיאור סוג הנתונים
url כתובת ה-URL שממנה אפשר להוריד את תמונת המצלמה. ‫string
דוגמה: "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1..."
token טוקן לשימוש בכותרת ההרשאה של HTTP כשמורידים את התמונה. 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 מופיעה רשימה מלאה של הקודים האלה.