Files
SpotiFLAC-Mobile/lib/services/playback_normalization.dart
T
zarzet 9eea6a1a03 feat(playback): add normalization pre-amp and track or album gain
Volume normalization levels tracks to the -18 LUFS ReplayGain
reference with no way to aim lower or keep album dynamics. Add a
pre-amp from -15 to +6 dB, shown with its resulting target loudness
(-7 dB targets -25 LUFS), and a Track or Album gain mode that falls
back to the other tag when one is missing.

The cache now keeps both gains per file, so changing either setting
re-levels the playing track without reading tags again. Volume stays
capped at the source level, so a positive pre-amp cannot clip, and
downloaded tags keep the standard -18 LUFS reference for other
players.
2026-10-20 00:39:08 +07:00

79 lines
2.4 KiB
Dart

import 'dart:math';
/// Caches successful tag reads by stable media identity. Descriptor paths are
/// short-lived and require their display-name hint to select the audio parser.
class PlaybackNormalizationCache {
final Future<Map<String, dynamic>> Function(String, {String? displayName})
readMetadata;
final void Function(Object)? onReadError;
final Map<String, ({double? track, double? album})> _gains = {};
int _generation = 0;
static final _gainNumber = RegExp(r'-?\d+(\.\d+)?');
PlaybackNormalizationCache({required this.readMetadata, this.onReadError});
void invalidate(String source) {
_gains.remove(source);
_generation++;
}
/// The player volume for [path]. [preampDb] shifts the -18 LUFS reference
/// the tags were written against, so -7 dB targets -25 LUFS. Volume never
/// exceeds 1.0: normalization only attenuates and cannot clip.
Future<double> volumeFor(
String path, {
String? cacheKey,
String? displayName,
double preampDb = 0,
bool preferAlbumGain = false,
}) async {
final gains = await _gainsFor(
path,
cacheKey: cacheKey,
displayName: displayName,
);
final gain = gains == null
? null
: preferAlbumGain
? gains.album ?? gains.track
: gains.track ?? gains.album;
if (gain == null) return 1.0;
return pow(10.0, (gain + preampDb) / 20.0).toDouble().clamp(0.0, 1.0);
}
Future<({double? track, double? album})?> _gainsFor(
String path, {
String? cacheKey,
String? displayName,
}) async {
final key = cacheKey ?? path;
final cached = _gains[key];
if (cached != null) return cached;
final generation = _generation;
try {
final metadata = await readMetadata(path, displayName: displayName);
if (metadata['error'] != null) {
onReadError?.call(metadata['error'] as Object);
return null;
}
final gains = (
track: _gain(metadata['replaygain_track_gain']),
album: _gain(metadata['replaygain_album_gain']),
);
if (generation == _generation) {
if (_gains.length >= 128) _gains.remove(_gains.keys.first);
_gains[key] = gains;
}
return gains;
} catch (error) {
onReadError?.call(error);
return null;
}
}
static double? _gain(Object? value) {
final match = _gainNumber.firstMatch(value?.toString() ?? '');
return match == null ? null : double.tryParse(match.group(0)!);
}
}