Improved Runtime Stability, Diagnostics, and Overlay System
This release focuses on SDK stability, safer rendering behavior, better diagnostics, and a more flexible overlay system for custom Lower Thirds and captions.
Safer Rendering Behavior
- Improved fallback behavior when WebGL is not initialized.
- Frames are now passed through directly or skipped safely instead of triggering repeated rendering crashes.
- Added software renderer detection to avoid running GPU-heavy effects in unsupported or degraded environments. Effects are no longer rendered when a software WebGL renderer is detected, because effects such as Blur and Beautification can become too slow and unstable in that mode.
- Updated isSupported checks to validate WebGL 1 availability, minimal WASM support, and the absence of a software renderer.
- Added error reporting when software rendering is detected so integrations can notify users or apply their own fallback logic. See SOFTWARE_RENDERER_SKIPPED.
WebGPU and WASM Improvements
- Added a method to switch processing from WebGPU to WASM at runtime. See setProvider.
- Reduced the size of test_inference assets by replacing JavaScript array-based test images with WebP images, cutting the related asset size from approximately 1.3 MB to about 55 KB.
Better Error Handling and Diagnostics
- Started migrating internal SDK components to the new SdkError exception format.
- Added more diagnostic information to model loading errors.
- Improved ErrorBus coverage for runtime errors in Color Filter and Low Light effects.
- Improved error propagation so integrations receive clearer information when something goes wrong.
Effect Pipeline Stability
- Updated the Color Filter effect to correctly resolve promise containers and callbacks.
- Fixed runtime crash scenarios in Color Filter and Low Light.
- Improved callback handling and async resolution behavior for more predictable effect initialization and updates.
Model Cache Behavior
- Cached models are no longer reused when model caching is disabled in the SDK configuration. This makes cache-related behavior more consistent with the provided configuration.
Recorder Improvements
- Updated the Recorder implementation to make it safer and more resilient during recording workflows.
Custom Lower Thirds and Captions
- Added support for custom Lower Thirds and captions via the new Custom Overlay system. See OverlayDefinition, CustomOverlayOptions and createComponent, Detailed Guide.
- Improved the previous Lower Thirds by rebuilding them on top of the new Custom Overlay system.