During a trip, the iOn Vision camera is continuously recording video to its onboard storage. The most common way that video is uploaded is by an enhanced DVR (EDVR) event. These videos are uploaded when the PEG script requests a video upload (such as for a high acceleration event) or the camera’s artificial intelligence (AI) algorithms recognize a predefined situation (such as speeding and tailgating) that could merit video capture. These events will have predefined resolutions, quality, and durations, and those video clips are uploaded to CTC at the end of each trip. As discussed previously, these uploads generate application messages with links to download the videos.
If the initial EDVR upload does not meet the application need, there are a couple of options. The application can use an endpoint to request an alternative version of the EDVR video. For example, you may want the automated EDVR uploads to use a low default resolution to moderate data use. This may create a need to request a higher-quality video to analyze some scenes more closely. This is accomplished using the POST {{BaseUrl}}/videos/edvr/request endpoint to request a higher resolution upload.
Another option is to use the DVR video endpoint, POST {{BaseUrl}}/videos/dvr/request, to upload a video for a custom time range with the video settings you want. The DVR service takes advantage of the fact that the camera is always recording to its local storage. As long as the video has not been overwritten by a subsequent trip, it is possible to use a DVR video endpoint to request videos that were not previously sent by the EDVR logic. An example where this is likely to be used is gathering a few minutes of video prior to a traffic incident. The DVR endpoint even includes the ability to create time-lapse videos to ration mobile data when sending clips of a longer duration.
After you call either of these endpoints, CTC will communicate a request for the camera to upload either a new version of the EDVR video or a new DVR video. The camera could be off at the time of the request, but CTC will store and forward that message when the camera checks in. After the camera uploads the video, you can use the GET {{BaseURL}}/videos endpoint to download the video.
NOTE: There are no application messages sent for EDVR or DVR upload requests. The application will need to poll using status and search functions to find completed uploads. The status functions will have links to the videos for download.