Voice + self-hosted LiveKit: low-resolution camera video and one-way stuttering

Falco · October 15, 2026, 5:58pm

Thanks for the report

github.com/discourse/discourse

FIX: Sharper, smoother camera video in LiveKit voice rooms (#44650)

main ← fix/livekit-camera-quality

merged 05:56PM - 15 Oct 26 UTC

xfalcox

+145 -24

Reported on Meta: https://meta.discourse.org/t/413325. With LiveKit, camera vide…o was low resolution (8–20 fps) and stuttered, on both self-hosted LiveKit and LiveKit Cloud. The LiveKit server logged `adding up track failed: duplicate layer` and `unbound buffer overflowing, dropping packets`. ### Viewers never received the full-quality camera stream `#applySubscriberQuality` asked for the MEDIUM simulcast layer whenever there were 6 or fewer camera publishers. No explicit layers were configured, so the SDK built MEDIUM from its `h360` preset (640×360, 450 kbps, 20 fps). The quality preference only changed the HIGH layer, which nobody subscribed to, and dynacast then paused HIGH at the publisher. - Cameras publish `videoSimulcastLayers` taken from the mesh camera ladder's lower rungs (new `cameraSimulcastLayersFor`), sized from the capture track's dimensions. - Subscribers pick HIGH up to 3 camera publishers, MEDIUM up to 6, and LOW above that, matching where the mesh ladder steps down. ### The camera could be published twice `syncLocalVideo` had no serialization. Starting the camera broadcasts state, and the resulting roster update called `syncLocalVideo` again while the first `publishTrack` was still in flight. `#videoPublication` was still null, so the track was published a second time. The SDK's "already published" guard doesn't catch this because it wraps raw `MediaStreamTrack`s in a fresh `LocalTrack` on every call. That left two encoders on one webcam, with the first publication orphaned until leave. `syncLocalVideo` calls now run through a promise queue. ### Tests - The camera publish test now asserts the simulcast layers. - The quality test covers HIGH, then MEDIUM above 3 publishers, then LOW above 6. - New regression test: a roster update during a slow camera publish leaves exactly one camera publication.

Let me know if this solves the issues!

Topic		Replies	Views
Live: Discord-style voice and video rooms, now bundled with Discourse :studio_microphone: Announcements live	82	4288	November 4, 2026
Live: background blur always fails in Brave Browser ("Background blur couldn't be started") - detached `<video>`.play() is aborted Bug live , brave-browser	3	121	October 30, 2026
Integrating Discourse Voice with LiveKit Integrations live	0	185	September 3, 2026
Bug: Livestream mixed content warning causing Onebox not to render Bug	5	1283	February 24, 2015
Vimeo links uploaded after 2020-12-18 play without audio on ipad using DiscourseHub Bug tablet	14	2164	February 19, 2021

Voice + self-hosted LiveKit: low-resolution camera video and one-way stuttering

Related topics