Error handling
Significant improvements have been made to error handling during video capturing and recording.
First, error handling is now much more comprehensive — for any error, you can retrieve both an error code and a human-readable description (in English). Many potential issues that were previously unchecked are now properly detected and have specific error codes assigned to them.
Possible error sources include:
- local webcams (with platform-specific handling for Windows, Linux, and macOS)
- FFmpeg (including file recording)
- GStreamer
- local file playback (using DirectX on Windows and AVFoundation on macOS).
Second, handling errors has become easier — an OnError event has been added to the components. This event also allows you to manage non-critical errors and decide whether the operation should be stopped. For example, during video playback via FFmpeg, audio-related errors are ignored by default, but you can now choose how to handle them.
The events are:
- TRVCamera.OnError (video capturing and remuxing)
- TRVCamRecorder.OnError (video recording)
- TRVAudioPlayer.OnError (audio recording)
In the current version, events for handling errors related to microphone audio input and playback have not yet been implemented. These will be added in one of the upcoming updates.