539 lines
18 KiB
Dart
539 lines
18 KiB
Dart
import 'dart:io';
|
|
import 'dart:ui';
|
|
|
|
import 'package:flutter/material.dart';
|
|
import 'package:material_symbols_icons/symbols.dart';
|
|
import 'package:plezy/widgets/app_icon.dart';
|
|
|
|
import '../media/media_server_client.dart';
|
|
import '../services/device_performance.dart';
|
|
import '../utils/app_logger.dart';
|
|
import '../utils/media_image_helper.dart';
|
|
import '../utils/obfuscation_utils.dart';
|
|
|
|
/// Tracks recent image load failures to log a periodic summary instead of
|
|
/// spamming per-image. Resets after [_logInterval] so recurring issues
|
|
/// remain visible.
|
|
int _imageFailureCount = 0;
|
|
DateTime _lastFailureLog = DateTime.now();
|
|
const _logInterval = Duration(seconds: 10);
|
|
|
|
Widget blurArtwork(Widget child, {double sigma = 30, bool clip = true}) {
|
|
if (!kBlurArtwork) return child;
|
|
final filtered = ImageFiltered(
|
|
imageFilter: ImageFilter.blur(sigmaX: sigma, sigmaY: sigma),
|
|
child: child,
|
|
);
|
|
return clip ? ClipRect(child: filtered) : filtered;
|
|
}
|
|
|
|
class OptimizedMediaImage extends StatelessWidget {
|
|
final MediaServerClient? client;
|
|
final String? imagePath;
|
|
final double? width;
|
|
final double? height;
|
|
final BoxFit fit;
|
|
final FilterQuality filterQuality;
|
|
final Widget Function(BuildContext, String)? placeholder;
|
|
final Widget Function(BuildContext, String, dynamic)? errorWidget;
|
|
final Duration fadeInDuration;
|
|
final bool enableTranscoding;
|
|
final String? cacheKey;
|
|
final Alignment alignment;
|
|
final IconData? fallbackIcon;
|
|
final ImageType imageType;
|
|
final String? localFilePath;
|
|
|
|
const OptimizedMediaImage._({
|
|
super.key,
|
|
this.client,
|
|
required this.imagePath,
|
|
this.width,
|
|
this.height,
|
|
this.fit = BoxFit.cover,
|
|
this.filterQuality = FilterQuality.medium,
|
|
this.placeholder,
|
|
this.errorWidget,
|
|
this.fadeInDuration = const Duration(milliseconds: 300),
|
|
this.enableTranscoding = true,
|
|
this.cacheKey,
|
|
this.alignment = Alignment.center,
|
|
this.fallbackIcon,
|
|
this.imageType = ImageType.poster,
|
|
this.localFilePath,
|
|
});
|
|
|
|
/// Generic constructor for optimized images.
|
|
const factory OptimizedMediaImage({
|
|
Key? key,
|
|
MediaServerClient? client,
|
|
required String? imagePath,
|
|
double? width,
|
|
double? height,
|
|
BoxFit fit,
|
|
FilterQuality filterQuality,
|
|
Widget Function(BuildContext, String)? placeholder,
|
|
Widget Function(BuildContext, String, dynamic)? errorWidget,
|
|
Duration fadeInDuration,
|
|
bool enableTranscoding,
|
|
String? cacheKey,
|
|
Alignment alignment,
|
|
IconData? fallbackIcon,
|
|
ImageType imageType,
|
|
String? localFilePath,
|
|
}) = OptimizedMediaImage._;
|
|
|
|
/// Named constructor for poster images with default fallback icon.
|
|
const OptimizedMediaImage.poster({
|
|
Key? key,
|
|
MediaServerClient? client,
|
|
required String? imagePath,
|
|
double? width,
|
|
double? height,
|
|
BoxFit fit = BoxFit.cover,
|
|
FilterQuality filterQuality = FilterQuality.medium,
|
|
Widget Function(BuildContext, String)? placeholder,
|
|
Widget Function(BuildContext, String, dynamic)? errorWidget,
|
|
Duration fadeInDuration = const Duration(milliseconds: 300),
|
|
bool enableTranscoding = true,
|
|
String? cacheKey,
|
|
Alignment alignment = Alignment.center,
|
|
IconData? fallbackIcon,
|
|
String? localFilePath,
|
|
}) : this._(
|
|
key: key,
|
|
client: client,
|
|
imagePath: imagePath,
|
|
width: width,
|
|
height: height,
|
|
fit: fit,
|
|
filterQuality: filterQuality,
|
|
placeholder: placeholder,
|
|
errorWidget: errorWidget,
|
|
fadeInDuration: fadeInDuration,
|
|
enableTranscoding: enableTranscoding,
|
|
cacheKey: cacheKey,
|
|
alignment: alignment,
|
|
fallbackIcon: fallbackIcon ?? Symbols.movie_rounded,
|
|
imageType: ImageType.poster,
|
|
localFilePath: localFilePath,
|
|
);
|
|
|
|
/// Named constructor for episode thumbnails.
|
|
const OptimizedMediaImage.thumb({
|
|
Key? key,
|
|
MediaServerClient? client,
|
|
required String? imagePath,
|
|
double? width,
|
|
double? height,
|
|
BoxFit fit = BoxFit.cover,
|
|
FilterQuality filterQuality = FilterQuality.medium,
|
|
Widget Function(BuildContext, String)? placeholder,
|
|
Widget Function(BuildContext, String, dynamic)? errorWidget,
|
|
Duration fadeInDuration = const Duration(milliseconds: 300),
|
|
bool enableTranscoding = true,
|
|
String? cacheKey,
|
|
Alignment alignment = Alignment.center,
|
|
IconData? fallbackIcon,
|
|
String? localFilePath,
|
|
}) : this._(
|
|
key: key,
|
|
client: client,
|
|
imagePath: imagePath,
|
|
width: width,
|
|
height: height,
|
|
fit: fit,
|
|
filterQuality: filterQuality,
|
|
placeholder: placeholder,
|
|
errorWidget: errorWidget,
|
|
fadeInDuration: fadeInDuration,
|
|
enableTranscoding: enableTranscoding,
|
|
cacheKey: cacheKey,
|
|
alignment: alignment,
|
|
fallbackIcon: fallbackIcon ?? Symbols.video_library_rounded,
|
|
imageType: ImageType.thumb,
|
|
localFilePath: localFilePath,
|
|
);
|
|
|
|
/// Named constructor for playlist images.
|
|
const OptimizedMediaImage.playlist({
|
|
Key? key,
|
|
MediaServerClient? client,
|
|
required String? imagePath,
|
|
double? width,
|
|
double? height,
|
|
BoxFit fit = BoxFit.cover,
|
|
FilterQuality filterQuality = FilterQuality.medium,
|
|
Widget Function(BuildContext, String)? placeholder,
|
|
Widget Function(BuildContext, String, dynamic)? errorWidget,
|
|
Duration fadeInDuration = const Duration(milliseconds: 300),
|
|
bool enableTranscoding = true,
|
|
String? cacheKey,
|
|
Alignment alignment = Alignment.center,
|
|
String? localFilePath,
|
|
}) : this._(
|
|
key: key,
|
|
client: client,
|
|
imagePath: imagePath,
|
|
width: width,
|
|
height: height,
|
|
fit: fit,
|
|
filterQuality: filterQuality,
|
|
placeholder: placeholder,
|
|
errorWidget: errorWidget,
|
|
fadeInDuration: fadeInDuration,
|
|
enableTranscoding: enableTranscoding,
|
|
cacheKey: cacheKey,
|
|
alignment: alignment,
|
|
fallbackIcon: Symbols.playlist_play_rounded,
|
|
imageType: ImageType.poster,
|
|
localFilePath: localFilePath,
|
|
);
|
|
|
|
/// Whether both width and height are explicitly set to finite positive values,
|
|
/// meaning we can skip the LayoutBuilder.
|
|
bool get _hasKnownDimensions =>
|
|
width != null && width!.isFinite && width! > 0 && height != null && height!.isFinite && height! > 0;
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
final path = localFilePath;
|
|
if (path == null) {
|
|
return _buildResolved(context, _LocalFileResolution.missing, null);
|
|
}
|
|
return _ResolvedLocalFile(path: path, builder: _buildResolved);
|
|
}
|
|
|
|
Widget _buildResolved(BuildContext context, _LocalFileResolution resolution, File? localFile) {
|
|
if (resolution == _LocalFileResolution.pending) return _surfacePlaceholder(context);
|
|
final hasLocal = resolution == _LocalFileResolution.present;
|
|
|
|
if (!hasLocal && (imagePath == null || imagePath!.isEmpty)) {
|
|
return _buildFallback(context);
|
|
}
|
|
|
|
if (_hasKnownDimensions) {
|
|
return blurArtwork(
|
|
hasLocal
|
|
? _buildLocalFileImage(context, localFile!, width!, height!)
|
|
: _buildCachedImage(context, width!, height!),
|
|
);
|
|
}
|
|
|
|
return blurArtwork(
|
|
LayoutBuilder(
|
|
builder: (context, constraints) {
|
|
final effectiveWidth = _resolvedDimension(width, constraints.maxWidth, 300.0);
|
|
final effectiveHeight = _resolvedDimension(height, constraints.maxHeight, 450.0);
|
|
return hasLocal
|
|
? _buildLocalFileImage(context, localFile!, effectiveWidth, effectiveHeight)
|
|
: _buildCachedImage(context, effectiveWidth, effectiveHeight);
|
|
},
|
|
),
|
|
);
|
|
}
|
|
|
|
Widget _buildLocalFileImage(BuildContext context, File file, double effectiveWidth, double effectiveHeight) {
|
|
final dpr = MediaImageHelper.effectiveDevicePixelRatio(context);
|
|
final scaledWidth = effectiveWidth * dpr;
|
|
final scaledHeight = effectiveHeight * dpr;
|
|
final (memWidth, memHeight) = MediaImageHelper.getMemCacheDimensions(
|
|
displayWidth: scaledWidth.isFinite && scaledWidth > 0 ? scaledWidth.round() : 0,
|
|
displayHeight: scaledHeight.isFinite && scaledHeight > 0 ? scaledHeight.round() : 0,
|
|
imageType: imageType,
|
|
);
|
|
|
|
return Image(
|
|
image: MediaImageHelper.boundedDecode(FileImage(file), memWidth: memWidth, memHeight: memHeight),
|
|
width: width,
|
|
height: height,
|
|
// Artwork is decorative: the enclosing card exposes one merged node
|
|
// with the title, and a per-image node just grows the semantics tree
|
|
// the TV a11y services make Flutter rebuild every frame.
|
|
excludeFromSemantics: true,
|
|
fit: fit,
|
|
filterQuality: filterQuality,
|
|
alignment: alignment,
|
|
errorBuilder: (context, error, stackTrace) {
|
|
if (errorWidget != null) {
|
|
return errorWidget!(context, file.path, error);
|
|
}
|
|
return _buildErrorWidget(context, error);
|
|
},
|
|
);
|
|
}
|
|
|
|
static double _resolvedDimension(double? explicit, double constraintMax, double fallback) {
|
|
// Pick the explicit size when it's a finite positive number, otherwise
|
|
// fall back to the constraint or a sensible default so we don't end up
|
|
// with NaN/Infinity when rounding to ints for caching.
|
|
if (explicit == null || explicit.isNaN || explicit.isInfinite || explicit <= 0) {
|
|
if (constraintMax.isFinite && constraintMax > 0) {
|
|
return constraintMax;
|
|
}
|
|
return fallback;
|
|
}
|
|
return explicit;
|
|
}
|
|
|
|
Widget _buildCachedImage(BuildContext context, double effectiveWidth, double effectiveHeight) {
|
|
final devicePixelRatio = MediaImageHelper.effectiveDevicePixelRatio(context);
|
|
|
|
final imageUrl = MediaImageHelper.getOptimizedImageUrl(
|
|
client: client,
|
|
thumbPath: imagePath,
|
|
maxWidth: effectiveWidth,
|
|
maxHeight: effectiveHeight,
|
|
devicePixelRatio: devicePixelRatio,
|
|
enableTranscoding: enableTranscoding,
|
|
imageType: imageType,
|
|
);
|
|
|
|
if (imageUrl.isEmpty) {
|
|
return _buildFallback(context);
|
|
}
|
|
|
|
final scaledWidth = effectiveWidth * devicePixelRatio;
|
|
final scaledHeight = effectiveHeight * devicePixelRatio;
|
|
final (memWidth, memHeight) = MediaImageHelper.getMemCacheDimensions(
|
|
displayWidth: scaledWidth.isFinite && scaledWidth > 0 ? scaledWidth.round() : 0,
|
|
displayHeight: scaledHeight.isFinite && scaledHeight > 0 ? scaledHeight.round() : 0,
|
|
imageType: imageType,
|
|
);
|
|
|
|
final resizedProvider = MediaImageHelper.serverArtworkProvider(
|
|
imageUrl: imageUrl,
|
|
memWidth: memWidth,
|
|
memHeight: memHeight,
|
|
cacheKey: cacheKey,
|
|
);
|
|
|
|
// Reduced tier: swap in directly, no fade machinery at all.
|
|
if (DevicePerformance.isReduced) {
|
|
return Image(
|
|
image: resizedProvider,
|
|
width: width,
|
|
height: height,
|
|
// Decorative — see the Image.file branch.
|
|
excludeFromSemantics: true,
|
|
fit: fit,
|
|
filterQuality: filterQuality,
|
|
alignment: alignment,
|
|
errorBuilder: _networkErrorBuilder(imageUrl),
|
|
frameBuilder: (context, child, frame, wasSynchronouslyLoaded) {
|
|
if (wasSynchronouslyLoaded || frame != null) return child;
|
|
return _buildPlaceholder(context, imageUrl);
|
|
},
|
|
);
|
|
}
|
|
|
|
return _FadeInNetworkImage(
|
|
image: resizedProvider,
|
|
width: width,
|
|
height: height,
|
|
fit: fit,
|
|
filterQuality: filterQuality,
|
|
alignment: alignment,
|
|
duration: fadeInDuration,
|
|
placeholderBuilder: (context) => _buildPlaceholder(context, imageUrl),
|
|
errorBuilder: _networkErrorBuilder(imageUrl),
|
|
);
|
|
}
|
|
|
|
ImageErrorWidgetBuilder _networkErrorBuilder(String imageUrl) {
|
|
return (context, error, stackTrace) {
|
|
_imageFailureCount++;
|
|
final now = DateTime.now();
|
|
if (now.difference(_lastFailureLog) >= _logInterval) {
|
|
appLogger.w('Image load failed ($_imageFailureCount since last log): $error');
|
|
_imageFailureCount = 0;
|
|
_lastFailureLog = now;
|
|
}
|
|
if (errorWidget != null) {
|
|
return errorWidget!(context, imageUrl, error);
|
|
}
|
|
return _buildErrorWidget(context, error);
|
|
};
|
|
}
|
|
|
|
Widget _surfacePlaceholder(BuildContext context, {IconData? icon, Color? iconColor, bool fillParent = false}) {
|
|
final theme = Theme.of(context).colorScheme;
|
|
return Container(
|
|
width: fillParent ? null : width,
|
|
height: fillParent ? null : height,
|
|
color: theme.surfaceContainerHighest,
|
|
child: icon == null
|
|
? null
|
|
: Center(child: AppIcon(icon, fill: 1, size: 40, color: iconColor ?? theme.onSurfaceVariant)),
|
|
);
|
|
}
|
|
|
|
Widget _buildPlaceholder(BuildContext context, String imageUrl) {
|
|
if (placeholder != null) return placeholder!(context, imageUrl);
|
|
return _surfacePlaceholder(context, icon: fallbackIcon, iconColor: Colors.white54);
|
|
}
|
|
|
|
Widget _buildErrorWidget(BuildContext context, dynamic _) => _surfacePlaceholder(
|
|
context,
|
|
icon: fallbackIcon ?? Symbols.broken_image_rounded,
|
|
fillParent: !_hasKnownDimensions,
|
|
);
|
|
|
|
Widget _buildFallback(BuildContext context) =>
|
|
_surfacePlaceholder(context, icon: fallbackIcon ?? Symbols.image_not_supported_rounded);
|
|
}
|
|
|
|
/// Fades a network image in by animating the image paint's alpha
|
|
/// (`Image.opacity` → `RawImage`), not by wrapping it in an opacity widget:
|
|
/// a widget-opacity fade is a tile-sized saveLayer per in-flight image, and
|
|
/// grid scrolling runs many of them concurrently — a real GPU cost on the
|
|
/// weak GLES devices most Android TVs are. The opaque placeholder sits below
|
|
/// in a Stack until the fade completes, so the visual result matches the
|
|
/// AnimatedSwitcher cross-fade this replaces.
|
|
class _FadeInNetworkImage extends StatefulWidget {
|
|
const _FadeInNetworkImage({
|
|
required this.image,
|
|
required this.width,
|
|
required this.height,
|
|
required this.fit,
|
|
required this.filterQuality,
|
|
required this.alignment,
|
|
required this.duration,
|
|
required this.placeholderBuilder,
|
|
required this.errorBuilder,
|
|
});
|
|
|
|
final ImageProvider image;
|
|
final double? width;
|
|
final double? height;
|
|
final BoxFit fit;
|
|
final FilterQuality filterQuality;
|
|
final Alignment alignment;
|
|
final Duration duration;
|
|
final WidgetBuilder placeholderBuilder;
|
|
final ImageErrorWidgetBuilder errorBuilder;
|
|
|
|
@override
|
|
State<_FadeInNetworkImage> createState() => _FadeInNetworkImageState();
|
|
}
|
|
|
|
class _FadeInNetworkImageState extends State<_FadeInNetworkImage> with SingleTickerProviderStateMixin {
|
|
// Starts fully visible so synchronously-available (memory-cached) images
|
|
// paint immediately; dropped to 0 only once we know the load is async.
|
|
late final AnimationController _opacity = AnimationController(vsync: this, duration: widget.duration, value: 1);
|
|
bool _sawFirstFrame = false;
|
|
bool _placeholderVisible = false;
|
|
|
|
@override
|
|
void didUpdateWidget(covariant _FadeInNetworkImage oldWidget) {
|
|
super.didUpdateWidget(oldWidget);
|
|
if (widget.image != oldWidget.image) {
|
|
// New stream: rearm so an async swap fades again (a memory-cached swap
|
|
// stays at full opacity via the wasSynchronouslyLoaded path).
|
|
_sawFirstFrame = false;
|
|
_placeholderVisible = false;
|
|
_opacity.value = 1;
|
|
}
|
|
}
|
|
|
|
@override
|
|
void dispose() {
|
|
_opacity.dispose();
|
|
super.dispose();
|
|
}
|
|
|
|
void _startFade() {
|
|
_sawFirstFrame = true;
|
|
_opacity.forward().whenComplete(() {
|
|
if (mounted && _placeholderVisible) setState(() => _placeholderVisible = false);
|
|
});
|
|
}
|
|
|
|
@override
|
|
Widget build(BuildContext context) {
|
|
return Image(
|
|
image: widget.image,
|
|
width: widget.width,
|
|
height: widget.height,
|
|
// Decorative — see OptimizedMediaImage.
|
|
excludeFromSemantics: true,
|
|
fit: widget.fit,
|
|
filterQuality: widget.filterQuality,
|
|
alignment: widget.alignment,
|
|
opacity: _opacity,
|
|
errorBuilder: widget.errorBuilder,
|
|
frameBuilder: (context, child, frame, wasSynchronouslyLoaded) {
|
|
if (wasSynchronouslyLoaded) return child;
|
|
if (frame == null && !_sawFirstFrame) {
|
|
// Async load in progress: hide the image and show the placeholder
|
|
// beneath until the first frame arrives. Mutating outside setState
|
|
// is fine here — we're inside build.
|
|
_opacity.value = 0;
|
|
_placeholderVisible = true;
|
|
} else if (frame != null && !_sawFirstFrame) {
|
|
_startFade();
|
|
}
|
|
if (!_placeholderVisible) return child;
|
|
return Stack(
|
|
alignment: Alignment.center,
|
|
fit: StackFit.passthrough,
|
|
children: [widget.placeholderBuilder(context), child],
|
|
);
|
|
},
|
|
);
|
|
}
|
|
}
|
|
|
|
enum _LocalFileResolution { pending, missing, present }
|
|
|
|
class _ResolvedLocalFile extends StatefulWidget {
|
|
const _ResolvedLocalFile({required this.path, required this.builder});
|
|
|
|
final String path;
|
|
final Widget Function(BuildContext context, _LocalFileResolution resolution, File? file) builder;
|
|
|
|
@override
|
|
State<_ResolvedLocalFile> createState() => _ResolvedLocalFileState();
|
|
}
|
|
|
|
class _ResolvedLocalFileState extends State<_ResolvedLocalFile> {
|
|
File? _file;
|
|
_LocalFileResolution _resolution = _LocalFileResolution.pending;
|
|
int _generation = 0;
|
|
|
|
@override
|
|
void initState() {
|
|
super.initState();
|
|
_resolve();
|
|
}
|
|
|
|
@override
|
|
void didUpdateWidget(_ResolvedLocalFile oldWidget) {
|
|
super.didUpdateWidget(oldWidget);
|
|
if (oldWidget.path != widget.path || _resolution == _LocalFileResolution.missing) _resolve();
|
|
}
|
|
|
|
void _resolve() {
|
|
final generation = ++_generation;
|
|
_file = null;
|
|
_resolution = _LocalFileResolution.pending;
|
|
final candidate = File(widget.path);
|
|
candidate.exists().then((exists) {
|
|
if (!mounted || generation != _generation) return;
|
|
setState(() {
|
|
_file = exists ? candidate : null;
|
|
_resolution = exists ? _LocalFileResolution.present : _LocalFileResolution.missing;
|
|
});
|
|
});
|
|
}
|
|
|
|
@override
|
|
void dispose() {
|
|
++_generation;
|
|
super.dispose();
|
|
}
|
|
|
|
@override
|
|
Widget build(BuildContext context) => widget.builder(context, _resolution, _file);
|
|
}
|