דף זה תורגם על ידי Cloud Translation API.

מסך

המסך של Google Nest Hub Max נתמך ב-API של Smart Device Management‏ (SDM). המכשיר הזה מחזיר את סוג המכשיר DISPLAY:

sdm.devices.types.DISPLAY

מכשיר Google Nest Hub Max כולל מצלמה, שפועלת כמו מכשיר מסוג CAMERA.

מאפיינים

חומרי עזר

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

מאפיין	תיאור	פקודות	אירועים
CameraEventImage	המאפיין הזה שייך לכל מכשיר שתומך ביצירת תמונות מאירועים.	GenerateImage
CameraImage	המאפיין הזה שייך לכל מכשיר שתומך בצילום תמונות.
CameraLiveStream	התכונה הזו שייכת לכל מכשיר שתומך בסטרימינג בשידור חי.	GenerateRtspStream ExtendRtspStream StopRtspStream
CameraMotion	התכונה הזו שייכת לכל מכשיר שתומך באירועי זיהוי תנועה.		תנועה
CameraPerson	התכונה הזו שייכת לכל מכשיר שתומך באירועי זיהוי אנשים.		אדם
CameraSound	התכונה הזו שייכת לכל מכשיר שתומך באירועי זיהוי צלילים.		צליל
מידע	התכונה הזו שייכת לכל מכשיר לקבלת מידע שקשור למכשיר.

JSON

אם מאפיין מסוים לא מופיע בתגובה של קריאת GET, סימן שהמאפיין או התכונה לא זמינים כרגע במכשיר. למידע נוסף, אפשר לקרוא את המאמר סוגי מכשירים.

{
  "type" : "sdm.devices.types.DISPLAY",
  "traits" : {
    "sdm.devices.traits.CameraEventImage" : {},
    "sdm.devices.traits.CameraImage" : {
      "maxImageResolution" : {
        "width" : 1280,
        "height" : 960
      }
    },
    "sdm.devices.traits.CameraLiveStream" : {
      "maxVideoResolution" : {
        "width" : 640,
        "height" : 480
      },
      "videoCodecs" : ["H264"],
      "audioCodecs" : ["AAC"],
      "supportedProtocols" : ["WEB_RTC"]
    },
    "sdm.devices.traits.CameraMotion" : {},
    "sdm.devices.traits.CameraPerson" : {},
    "sdm.devices.traits.CameraSound" : {},
    "sdm.devices.traits.Info" : {
      "customName" : "My device"
    }
  }
}

טיפול באירועים במצלמה

האירועים הבאים עשויים להיות מופעלים מסוג מכשיר DISPLAY:

סוג	רכיב	תיאור
אירוע	האירוע תנועה של המאפיין CameraMotion	המצלמה זיהתה תנועה.
אירוע	האירוע Person של המאפיין CameraPerson	המצלמה זיהתה אדם.
אירוע	אירוע צליל של תכונת CameraSound	המצלמה זיהתה צליל.

לדוגמה, כאן המצלמה זיהתה תנועה:

מטען ייעודי (payload)

{
  "eventId" : "aedf6813-6b9e-465a-a42a-4358b8b6161f",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.CameraMotion.Motion" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "-o1dVlAEusEUetEQB5hzQTXSAr...",
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

עומס העבודה של האירוע הזה מכיל eventId שאפשר להשתמש בו עם הפקודה GenerateImage. הפקודה הזו מחזירה כתובת URL להורדה של תמונת המצלמה שקשורה לאירוע:

בקשה

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

תשובה

{
  "results" : {
    "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "token" : "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, כדי להוריד את התמונה ברזולוציה של 480x360, מציינים את הרוחב או את הגובה:

רוחב

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 .

גישה לשידור חי

אפשר לגשת לשידור החי מהמצלמה. המערכת תומכת בפורמטים הבאים של סטרימינג במכשיר הזה:

RTSP

רשימה מלאה של המצלמות והפורמטים הנתמכים של השידורים מופיעה במכשירים נתמכים.

כדי לגשת לשידור חי, משתמשים בפקודה GenerateFormatStream המתאימה של המאפייןCameraLiveStream.

RTSP

בשידור RTSP, הפקודה GenerateRtspStream של הפקודה של המאפיין CameraLiveStream מחזירה את כתובת ה-URL של השידור ואת streamToken הקשור:

בקשה

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.GenerateRtspStream",
  "params" : {}
}

תשובה

{
  "results" : {
    "streamUrls" : {
      "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken"
    },
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
    "streamToken" : "g.0.streamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

לאחר מכן, משתמשים בכתובת ה-URL של הסטרימינג כדי לגשת לשידור החי של המצלמה:

rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken

אי אפשר לשתף כתובות URL של שידורים חיים ב-RTSP בין לקוחות. לקוח אחד בלבד יכול להשתמש בכתובת URL של שידור בכל פעם. אם כמה לקוחות רוצים להפעיל סטרימינג מאותה מצלמה בו-זמנית, צריך לשלוח פקודות RTSP לכל לקוח בנפרד, וכל לקוח צריך להשתמש בכתובת URL משלו לסטרימינג.

הארכת שידור חי

סשנים של שידורים חיים ממצלמה תקפים למשך 5 דקות בלבד. אם אתם צריכים להאריך את משך החיים של שידור חי, השתמשו בפקודה המתאימה ExtendFormatStream של המאפיין CameraLiveStream עבור פורמט הסטרימינג שיצרתם.

RTSP

כדי להרחיב שידור RTSP, משתמשים בפקודה ExtendRtspStream של הפקודה של המאפיין CameraLiveStream כדי לקבל ערכים חדשים של streamExtensionToken ו-streamToken:

בקשה

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.ExtendRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

תשובה

{
  "results" : {
    "streamExtensionToken" : "dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "streamToken" : "g.0.newStreamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

כדי להמשיך לצפות בשידור החי, מעדכנים את כתובת ה-URL של הסטרימינג באמצעות הערכים החדשים הבאים:

rtsps://someurl.com/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?auth=g.0.newStreamingToken

איך מפסיקים שידור חי

בכל פעם שאתם מפסיקים להשתמש בשידור חי מהמצלמה, עליכם לעצור אותו ולבטל את התוקף שלו. כדי לעשות זאת, משתמשים בפקודה המתאימה StopFormatStream של המאפייןCameraLiveStreamלפורמט הסטרימינג שיצרתם.

RTSP

כדי לעצור שידור RTSP, משתמשים באסימון כדי לבטל את התוקף שלו באמצעות הפקודה StopRtspStream של המאפיין CameraLiveStream:

בקשה

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.StopRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

תשובה

{}

שגיאות

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

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

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