v134 · webrtc
Camera Effects Status: Background Blur
Exposes read-only camera effect state on VideoFrameMetadata. This allows web developers to monitor changes in platform video effects like background blur. The pattern can be extended to support additional platform effects, such as lighting adjustments and auto face framing.
concepts
-
Background Blur Status
Sites can detect whether the OS-level background blur is active on a camera track.
-
Double-blur warning
The motivating user scenario: the OS is already blurring, the app is about to blur again, CPU spikes and the result looks worse. Live banner that detects the conflict and tells the user.
-
Effect Dashboard
Live dashboard: blur, face framing, lighting adjust state per frame via requestVideoFrameCallback + VideoFrameMetadata.
-
Video Quality Advisor
Simulate different device states (OS blur on, camera HW blur, low-res, pre-134) and see what quality recommendations the advisor gives — including when to skip software blur and how to monitor configurationchange events.
why it shipped
Camera effects implemented at the operating system level are becoming increasingly common on macOS, Windows, and ChromeOS. This can cause issues for video chat users. For example, if a user enables background blur on both their OS and in a video chat application, it can strain their system resources and cause the application's blur effect to malfunction. Additionally, users may forget they have enabled background blur at the OS level, leading to confusion when they are unable to disable it within a video chat application.