All of our cameras upload a thumbnail that is a (mostly) current snapshot of what the camera sees. These thumbnails can be retrieved for a given camera using a GET request to the following url:
As a note, all of our media.rhombusssytems.com endpoints use the same authentication as our main API, so be sure to include the authentication headers! To get the
mediaRegion for a camera, you can use the endpoint /camera/getMinimalCameraState to get a list of all cameras, and specifically in the response, you'll find the fields
To get a jpeg image at a specified time, you can use /video/getExactFrameUri to generate a frame URI. Executing a GET request to the returned frame URI with the same authentication headers will get the requested frame directly from the camera. You can also request a cropped image if necessary.
The most common and recommended way is to use iframes to embed our video player directly in the site. This comes with the added benefit that our camera events and analytics are pulled automatically into the player.
You will need to create shared streams for each camera that you want to embed. This can be done in the console, or from the API using the endpoint: /api/camera/createSharedLiveVideoStream. The response includes a url that you can add to an iframe like the following and embed in your application.
<iframe allow="fullscreen" frameborder="0" height="100%" width="100%" src="SHARED STREAM URL GOES HERE"></iframe>
A simple React app example for embedding an iframe can be found here.
URL Parameters have been created for additional control
We have enabled the use of parameters that can be in either the shared stream URL or the embedded iframe inline code. All can either be true/false depending on your intended implementation.
disableautoplay - Enable or disable the video to autoplay upon loading
hideevents - Enable or disable the timeline and related events to show
realtime - Enable or disable real time streaming of video by default
showheader - Enable or disable the zoom & streaming buttons at the top of the video
showfooter - Enable or disable the camera name and timestamp at the bottom of the video
You will follow the structure of
An example of how to download VOD footage directly from a camera can be found here. This method allows you to specify the start time and duration to access footage.
An example of how to download a clip corresponding to an alert can be found here. This example uses our webhook mechanism to be triggered whenever an alert is created in our system. The webhook payload includes all of the information required to download the corresponding clip. If you are using our API to get alert details, e.g. /api/event/getPolicyAlertsV2, there are similarly named fields as the webhook payload that can be used to construct the media request.
Updated about 2 months ago