Camera recordings consist of Video, Audio, Sensor, CAN bus, and AI inferencing data.
Recording
Edge Recording
- Continuous recording functionality is activated by default on all devices.
- SD card serves as the storage medium for all categories of event recordings.
- Recorded media are preserved on an SD card using a circular FIFO (First In, First Out) buffering mechanism. When the storage limit is reached, the oldest files are systematically erased to make room for new recordings.
- Disabling continuous recording results in the automatic deletion of event recordings, either post-upload or when the storage buffer reaches its capacity.
Cloud Recording
- Recordings triggered by system operations, such as REST API calls or actions performed via mobile applications, are directly uploaded to the cloud storage.
- Recordings initiated through user interaction, specifically via the recording button on the device, may be configured for automatic (push) or manual (pull) upload to the cloud depending on the predefined settings.
- Continuous recording to the cloud is available as an optional service, allowing for uninterrupted data backup directly to cloud storage. This service is subject to additional charges.
Recording retrieval
Recordings are retrievable from both the cloud and the device through a unified REST API framework.
Cloud-based recordings are accessible synchronously via the API response.
Recordings from the device are transmitted asynchronously using webhook notifications
Cloud recordings retrieval
Execute the Retrieve Recordings API to request access to available recordings from the Smarter AI Cloud. Upon request, the cloud promptly delivers the recordings. For synchronous delivery and immediate access, ensure to set the client
parameter to 0
when making the API call, thus preventing asynchronous retrieval from the device.
Combined Cloud/Edge recording retrieval
Edge recordings retrieval requires asynchronous messaging. Smarter AI delivers these messages to 3rd party services asynchronously over webhook.
- Step 1 - Register your service endpoints with Smarter AI webhook and subscribe to the recording retrieval-related topics.
- Step 2 - Use Recording list API to obtain a list of available recordings. Insert
1
in theclient
parameter to request recordings from the device storage. - Step 3 - The Smarter AI Cloud instantly delivers recordings stored in the cloud through the API response, while additional recordings retrieved from the edge are distributed via multiple webhook notifications. Refer to webhook page for details related to the recording retrieval process.
- The following figure is a simplified illustration of recording retrieval process. The black arrows represent REST communication, indicating synchronous data exchange, while the green arrows depict asynchronous messaging between components.