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..9f96e8836 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 builder to display while the track is loading. + /// + /// On iOS, this has no effect when [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); @@ -211,7 +217,7 @@ class _VideoTrackRendererState extends State { } Widget _videoViewForWeb() => !_rendererReadyForWeb - ? Container() + ? (widget.placeholderBuilder?.call(context) ?? const SizedBox.shrink()) : Builder( key: _viewRegistration.key, builder: (ctx) { @@ -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, ); } @@ -281,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