From 96e4090bc743d97b7cf93f5d49194903b5c6ab12 Mon Sep 17 00:00:00 2001 From: Bruno D'Luka Date: Sun, 14 Jun 2026 16:07:22 -0300 Subject: [PATCH 1/2] feat: VideoTrackRender.placeholderBuilder --- .changes/track-render-placeholder | 1 + lib/src/widgets/video_track_renderer.dart | 8 ++++++++ 2 files changed, 9 insertions(+) create mode 100644 .changes/track-render-placeholder diff --git a/.changes/track-render-placeholder b/.changes/track-render-placeholder new file mode 100644 index 000000000..aeb0b1ef9 --- /dev/null +++ b/.changes/track-render-placeholder @@ -0,0 +1 @@ +minor type="added" "Widget Placeholder added for VideoTrackRenderer" diff --git a/lib/src/widgets/video_track_renderer.dart b/lib/src/widgets/video_track_renderer.dart index 2457129e4..ea7a5df25 100644 --- a/lib/src/widgets/video_track_renderer.dart +++ b/lib/src/widgets/video_track_renderer.dart @@ -76,6 +76,11 @@ class VideoTrackRenderer extends StatefulWidget { /// ratio), avoiding an under-sized layer on retina / high-density displays. final AdaptiveStreamPixelDensity adaptiveStreamPixelDensity; + /// Placeholder widget to display while the track is loading. + /// + /// This has no effect if [renderMode] is [VideoRenderMode.platformView]. + final WidgetBuilder? placeholderBuilder; + const VideoTrackRenderer( this.track, { this.fit = VideoViewFit.contain, @@ -85,6 +90,7 @@ class VideoTrackRenderer extends StatefulWidget { this.cachedRenderer, this.autoCenter = true, this.adaptiveStreamPixelDensity = AdaptiveStreamPixelDensity.auto, + this.placeholderBuilder, Key? key, }) : super(key: key); @@ -224,6 +230,7 @@ class _VideoTrackRendererState extends State { mirror: _shouldMirror(), filterQuality: FilterQuality.medium, objectFit: widget.fit.toRTCType(), + placeholderBuilder: widget.placeholderBuilder, ); }, ); @@ -245,6 +252,7 @@ class _VideoTrackRendererState extends State { mirror: _shouldMirror(), filterQuality: FilterQuality.medium, objectFit: widget.fit.toRTCType(), + placeholderBuilder: widget.placeholderBuilder, ); } From 4d8e047b169b4d81cc1a014d397e5d84a4bcce0b Mon Sep 17 00:00:00 2001 From: Bruno D'Luka Date: Sun, 21 Jun 2026 11:15:35 -0300 Subject: [PATCH 2/2] fix: Placeholder on the Web --- lib/src/widgets/video_track_renderer.dart | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/lib/src/widgets/video_track_renderer.dart b/lib/src/widgets/video_track_renderer.dart index ea7a5df25..9f96e8836 100644 --- a/lib/src/widgets/video_track_renderer.dart +++ b/lib/src/widgets/video_track_renderer.dart @@ -76,9 +76,9 @@ class VideoTrackRenderer extends StatefulWidget { /// ratio), avoiding an under-sized layer on retina / high-density displays. final AdaptiveStreamPixelDensity adaptiveStreamPixelDensity; - /// Placeholder widget to display while the track is loading. + /// Placeholder builder to display while the track is loading. /// - /// This has no effect if [renderMode] is [VideoRenderMode.platformView]. + /// On iOS, this has no effect when [renderMode] is [VideoRenderMode.platformView]. final WidgetBuilder? placeholderBuilder; const VideoTrackRenderer( @@ -217,7 +217,7 @@ class _VideoTrackRendererState extends State { } Widget _videoViewForWeb() => !_rendererReadyForWeb - ? Container() + ? (widget.placeholderBuilder?.call(context) ?? const SizedBox.shrink()) : Builder( key: _viewRegistration.key, builder: (ctx) { @@ -289,7 +289,7 @@ class _VideoTrackRendererState extends State { }, ); } - return Container(); + return widget.placeholderBuilder?.call(context) ?? const SizedBox.shrink(); }); // FutureBuilder will cause flickering for flutter web. so using