dustin/Melo
1
0
Fork 0
Code Issues Pull Requests 3 Actions Packages Projects Releases Wiki Activity

Listen zeigen, welcher Titel gerade laeuft

Browse Source 
Bisher scrollte man durch die Bibliothek und musste raten, wo man ist —
die einzige Rueckmeldung war die Leiste ganz unten.

Drei tanzende Balken ueber dem Coverbild des laufenden Titels, sein Name
in Rot. Die Balken liegen auf dem Cover statt daneben: eine vierte Spalte
haette dem Titel Platz genommen und die Zeile bei jedem Titelwechsel in
der Breite springen lassen. Pausiert bleibt die Markierung stehen, die
Balken stehen still. Bei abgeschalteten Systemanimationen ebenfalls — eine
Endlosschleife ist genau das, was diese Einstellung vermeiden soll.

Die Markierung sitzt in SongZeile und gilt damit in einem Rutsch fuer
Meine Musik, Favoriten, Suche, Kuenstler, Kategorie und "Zuletzt
hinzugefuegt". Warteschlange und Wiedergabeliste bauen ihre Zeilen selbst
(dort steht rechts Entfernen statt Herz und Menue) und haben dasselbe
Zeichen einzeln bekommen.

Nur die laufende Zeile hoert auf den Wiedergabe-Zustand: der meldet auch
den Pufferstand und feuert mehrmals pro Sekunde. Haenge jede sichtbare
Zeile daran, baute sich die halbe Liste staendig neu auf.

Aus dem Code-Review nachgebessert: Startwert fuer den Strom, sonst
erschien die Markierung beim Zurueckscrollen einen Frame zu spaet; die
Zeile aendert beim Wechsel nicht mehr die Form ihres Aufbaus, sonst verlor
das Herz daneben sein Abo und sah kurz leer aus; die Wiedergabeliste
bekam die Markierung ueberhaupt erst (der Changelog hatte sie faelschlich
schon behauptet); der Abdunkel-Schleier nimmt den Eckenradius jetzt
entgegen statt ihn fest zu verdrahten.

Testluecke geschlossen, die der Review benannt hat: geprueft waren nur die
Regel und die Balken je fuer sich, die Verdrahtung dazwischen nicht —
genau dort sassen alle drei Fehler.

411 Tests gruen (vorher 396), flutter analyze ohne Befund, Release-APK
gebaut.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013xAHJTJM6UUqmjUgk1PUEd
This commit is contained in:
Hermes (Server)
2026-08-23 20:54:45 +02:00
co-authored by Claude Opus 5
parent ca28264c0e
commit 80948f1ad5
9 changed files with 792 additions and 75 deletions
Download Patch File Download Diff File Expand all files Collapse all files
lib/library/song_list.dart
+58 -7
View File
@@ -7,10 +7,12 @@ import '../playlists/create_playlist_dialog.dart';
import '../settings/app_settings.dart';
import '../shared/cover.dart';
import '../shared/favorite_button.dart';
import '../shared/lauf_balken.dart';
import 'category_service.dart';
import 'database.dart';
import 'playlist_service.dart';
import 'song_detail_sheet.dart';
import '../shared/theme.dart';
import 'song_media.dart';
/// Scrollbare Songliste; Tippen spielt die ganze Liste ab dem Song ab.
@@ -185,20 +187,69 @@ class SongZeile extends StatelessWidget {
@override
Widget build(BuildContext context) {
// Der Handler wird erst beim Antippen gebraucht und deshalb auch erst
// dann gelesen: so lässt sich eine Zeile darstellen, ohne dass ein
// laufender Player bereitstehen muss.
// Nullable gelesen: ohne laufenden Player (etwa im Widget-Test) bleibt
// die Zeile darstellbar, nur ohne Lauf-Markierung.
final handler = context.read<MeloAudioHandler?>();
final categories = context.watch<CategoryService>();
final settings = context.watch<AppSettings>();
final cover = categories.coverFor(song,
groupByCategory: settings.groupCoversByCategory);
return StreamBuilder<MediaItem?>(
stream: handler?.mediaItem,
// Der Strom liefert seinen aktuellen Wert erst im nächsten Frame.
// Ohne diesen Startwert erschiene die laufende Zeile beim Zurückscrollen
// einen Frame lang unmarkiert — Balken und rote Schrift ploppen nach.
initialData: handler?.mediaItem.valueOrNull,
builder: (context, laufSnap) {
final markiert = istAmLaufen(laufSnap.data, song.id);
// Nur die laufende Zeile hört auf den Wiedergabe-Zustand: der meldet
// auch den Pufferstand und feuert mehrmals pro Sekunde. Der
// StreamBuilder bleibt trotzdem immer stehen — verschwände er,
// änderte sich die Form des Baums, und das Herz daneben würde sein
// Abo verlieren und kurz leer aussehen.
return StreamBuilder<PlaybackState>(
stream: markiert ? handler?.playbackState : null,
initialData: handler?.playbackState.valueOrNull,
builder: (context, zustandSnap) => _zeile(
context,
categories: categories,
settings: settings,
cover: cover,
markiert: markiert,
spielt: markiert && (zustandSnap.data?.playing ?? false),
),
);
},
);
}
Widget _zeile(
BuildContext context, {
required CategoryService categories,
required AppSettings settings,
required String? cover,
required bool markiert,
required bool spielt,
}) {
return ListTile(
leading: CoverImage(
artUri: cover != null ? Uri.file(cover) : null,
size: 48,
leading: LaufMarkierung(
markiert: markiert,
spielt: spielt,
radius: 6,
child: CoverImage(
artUri: cover != null ? Uri.file(cover) : null,
size: 48,
radius: 6,
),
),
title: Text(
song.title,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: markiert
? const TextStyle(color: MeloTheme.red, fontWeight: FontWeight.w600)
: null,
),
title: Text(song.title, maxLines: 1, overflow: TextOverflow.ellipsis),
subtitle: Text(
_subtitle(song, categories.of(song.id)),
maxLines: 1,
lib/player/audio_handler.dart
+9
View File
@@ -88,6 +88,15 @@ String? navidromeIdOf(MediaItem item) => item.extras?['navidromeId'] as String?;
/// der nur am Server liegt. Trägt Historie, Wiedergabezähler und Resume.
String? songIdOf(MediaItem item) => item.extras?['songId'] as String?;
/// Ob der Titel mit der Bibliotheks-UUID [songId] gerade in der Wiedergabe
/// steht. [aktuell] ist der laufende Eintrag, oder `null`, wenn nichts läuft.
///
/// Der leere [songId] gilt nie als laufend: Titel, die nur am Server liegen,
/// haben keine UUID, und ohne diese Prüfung markierte ein Server-Titel jede
/// Zeile, der ebenfalls eine fehlt.
bool istAmLaufen(MediaItem? aktuell, String songId) =>
songId.isNotEmpty && aktuell != null && songIdOf(aktuell) == songId;
/// Ob für [item] im Server-Cache nachgesehen wird. Titel vom Gerät liegen
/// bereits als Datei vor — für sie darf der Server nie befragt werden.
bool nutztServerCache(MediaItem item) => navidromeIdOf(item) != null;
lib/player/queue_screen.dart
+76 -25
View File
@@ -3,6 +3,7 @@ import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
import '../shared/cover.dart';
import '../shared/lauf_balken.dart';
import '../shared/theme.dart';
import 'audio_handler.dart';
@@ -38,31 +39,13 @@ class QueueScreen extends StatelessWidget {
itemCount: queue.length,
onReorderItem: (oldIndex, newIndex) =>
handler.moveQueueItem(oldIndex, newIndex),
itemBuilder: (context, i) {
final item = queue[i];
final playing = item.id == currentId;
return ListTile(
key: ValueKey(item.id),
leading: CoverImage(artUri: item.artUri, size: 48, radius: 6),
title: Text(
item.title,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: playing
? const TextStyle(
color: MeloTheme.red, fontWeight: FontWeight.bold)
: null,
),
subtitle: Text(item.artist ?? 'Unbekannt',
maxLines: 1, overflow: TextOverflow.ellipsis),
trailing: IconButton(
tooltip: 'Aus Warteschlange entfernen',
icon: const Icon(Icons.close),
onPressed: () => handler.removeQueueItemAt(i),
),
onTap: () => handler.skipToQueueItem(i),
);
},
itemBuilder: (context, i) => _Zeile(
key: ValueKey(queue[i].id),
item: queue[i],
laeuft: queue[i].id == currentId,
onSpringen: () => handler.skipToQueueItem(i),
onEntfernen: () => handler.removeQueueItemAt(i),
),
);
},
);
@@ -71,3 +54,71 @@ class QueueScreen extends StatelessWidget {
);
}
}
/// Eine Zeile der Warteschlange.
///
/// Eigene Klasse, damit der Wiedergabe-Zustand (läuft / pausiert) hier
/// beobachtet wird statt in einem dritten `StreamBuilder`, der die ganze
/// Liste umschließt und bei jedem Pausieren neu aufbaut.
class _Zeile extends StatelessWidget {
const _Zeile({
super.key,
required this.item,
required this.laeuft,
required this.onSpringen,
required this.onEntfernen,
});
final MediaItem item;
/// Dieser Eintrag steht in der Wiedergabe — auch pausiert.
final bool laeuft;
final VoidCallback onSpringen;
final VoidCallback onEntfernen;
@override
Widget build(BuildContext context) {
final handler = context.read<MeloAudioHandler>();
// Nur die laufende Zeile hört wirklich zu — der Zustand meldet auch den
// Pufferstand und feuert mehrmals pro Sekunde. Der StreamBuilder bleibt
// aber stehen, damit die Zeile beim Titelwechsel nicht ihre Form ändert
// und dabei ihr Coverbild neu laden muss.
return StreamBuilder<PlaybackState>(
stream: laeuft ? handler.playbackState : null,
initialData: handler.playbackState.valueOrNull,
builder: (context, zustandSnap) =>
_kachel(spielt: laeuft && (zustandSnap.data?.playing ?? false)),
);
}
Widget _kachel({required bool spielt}) {
return ListTile(
// Dasselbe Zeichen wie in der Bibliothek: Balken über dem Cover,
// damit man dieselbe Stelle wiedererkennt.
leading: LaufMarkierung(
markiert: laeuft,
spielt: spielt,
radius: 6,
child: CoverImage(artUri: item.artUri, size: 48, radius: 6),
),
title: Text(
item.title,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: laeuft
? const TextStyle(
color: MeloTheme.red, fontWeight: FontWeight.bold)
: null,
),
subtitle: Text(item.artist ?? 'Unbekannt',
maxLines: 1, overflow: TextOverflow.ellipsis),
trailing: IconButton(
tooltip: 'Aus Warteschlange entfernen',
icon: const Icon(Icons.close),
onPressed: onEntfernen,
),
onTap: onSpringen,
);
}
}
lib/playlists/playlist_detail_screen.dart
+99 -43
View File
@@ -1,3 +1,4 @@
import 'package:audio_service/audio_service.dart';
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
@@ -8,6 +9,7 @@ import '../library/song_media.dart';
import '../player/audio_handler.dart';
import '../settings/app_settings.dart';
import '../shared/cover.dart';
import '../shared/lauf_balken.dart';
import '../shared/theme.dart';
/// Playlist-Detailansicht: Songs anzeigen, per Drag & Drop umsortieren, entfernen.
@@ -18,10 +20,7 @@ class PlaylistDetailScreen extends StatelessWidget {
@override
Widget build(BuildContext context) {
final db = context.read<MeloDb>();
final handler = context.read<MeloAudioHandler>();
final service = context.read<PlaylistService>();
final categories = context.watch<CategoryService>();
final settings = context.watch<AppSettings>();
return Scaffold(
appBar: AppBar(title: Text(playlist.name)),
body: StreamBuilder<List<Song>>(
@@ -48,49 +47,106 @@ class PlaylistDetailScreen extends StatelessWidget {
reordered.insert(newIndex, moved);
service.reorderAll(playlist.id, reordered.map((s) => s.id).toList());
},
itemBuilder: (context, i) {
final s = songs[i];
return ListTile(
key: ValueKey(s.id),
leading: Builder(builder: (context) {
final cover = categories.coverFor(s,
groupByCategory: settings.groupCoversByCategory);
return CoverImage(
artUri: cover != null ? Uri.file(cover) : null,
size: 48,
radius: 6,
);
}),
title: Text(s.title, maxLines: 1, overflow: TextOverflow.ellipsis),
subtitle: Text(s.artist ?? 'Unbekannt',
maxLines: 1, overflow: TextOverflow.ellipsis),
trailing: IconButton(
tooltip: 'Aus Playlist entfernen',
icon: const Icon(Icons.remove_circle_outline),
onPressed: () => service.removeSongFromPlaylist(playlist.id, s.id),
),
onTap: () async {
try {
await playSongs(
handler,
songs,
i,
coverOf: (song) => categories.coverFor(song,
groupByCategory: settings.groupCoversByCategory),
);
} catch (e) {
if (context.mounted) {
ScaffoldMessenger.of(context).showSnackBar(
SnackBar(content: Text('Wiedergabe fehlgeschlagen: $e')),
);
}
}
},
);
},
itemBuilder: (context, i) => _Zeile(
key: ValueKey(songs[i].id),
song: songs[i],
alleSongs: songs,
index: i,
onEntfernen: () =>
service.removeSongFromPlaylist(playlist.id, songs[i].id),
),
);
},
),
);
}
}
/// Eine Zeile der Wiedergabeliste.
///
/// Nicht [SongZeile]: hier steht rechts „Aus Playlist entfernen" statt Herz
/// und Menü. Die Lauf-Markierung ist dieselbe — der Nutzer soll dasselbe
/// Zeichen sehen wie in der Bibliothek.
class _Zeile extends StatelessWidget {
const _Zeile({
super.key,
required this.song,
required this.alleSongs,
required this.index,
required this.onEntfernen,
});
final Song song;
final List<Song> alleSongs;
final int index;
final VoidCallback onEntfernen;
@override
Widget build(BuildContext context) {
final handler = context.read<MeloAudioHandler>();
final categories = context.watch<CategoryService>();
final settings = context.watch<AppSettings>();
final cover = categories.coverFor(song,
groupByCategory: settings.groupCoversByCategory);
return StreamBuilder<MediaItem?>(
stream: handler.mediaItem,
initialData: handler.mediaItem.valueOrNull,
builder: (context, laufSnap) {
final markiert = istAmLaufen(laufSnap.data, song.id);
return StreamBuilder<PlaybackState>(
stream: markiert ? handler.playbackState : null,
initialData: handler.playbackState.valueOrNull,
builder: (context, zustandSnap) => ListTile(
leading: LaufMarkierung(
markiert: markiert,
spielt: markiert && (zustandSnap.data?.playing ?? false),
radius: 6,
child: CoverImage(
artUri: cover != null ? Uri.file(cover) : null,
size: 48,
radius: 6,
),
),
title: Text(
song.title,
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: markiert
? const TextStyle(
color: MeloTheme.red, fontWeight: FontWeight.w600)
: null,
),
subtitle: Text(song.artist ?? 'Unbekannt',
maxLines: 1, overflow: TextOverflow.ellipsis),
trailing: IconButton(
tooltip: 'Aus Playlist entfernen',
icon: const Icon(Icons.remove_circle_outline),
onPressed: onEntfernen,
),
onTap: () async {
final messenger = ScaffoldMessenger.of(context);
try {
final uebersprungen = await playSongs(
handler,
alleSongs,
index,
coverOf: (s) => categories.coverFor(s,
groupByCategory: settings.groupCoversByCategory),
);
if (uebersprungen > 0) {
messenger.showSnackBar(
SnackBar(content: Text(offlineHinweis(uebersprungen))),
);
}
} catch (e) {
messenger.showSnackBar(
SnackBar(content: Text('Wiedergabe fehlgeschlagen: $e')),
);
}
},
),
);
},
);
}
}
lib/shared/lauf_balken.dart
+175
View File
@@ -0,0 +1,175 @@
import 'dart:math' as math;
import 'package:flutter/material.dart';
import 'theme.dart';
/// Drei tanzende Balken — das Zeichen dafür, dass genau dieser Titel läuft.
///
/// Bei [laeuft] `false` (pausiert) stehen sie still, statt zu verschwinden:
/// die Zeile bleibt als „hier bist du gerade" markiert, zeigt aber, dass
/// nichts vorangeht. Sind die Systemanimationen abgeschaltet, stehen sie
/// ebenfalls still — eine Endlosschleife ist genau das, was diese
/// Einstellung vermeiden soll.
class LaufBalken extends StatefulWidget {
const LaufBalken({
super.key,
required this.laeuft,
this.hoehe = 16,
this.farbe = Colors.white,
});
final bool laeuft;
final double hoehe;
final Color farbe;
@override
State<LaufBalken> createState() => _LaufBalkenState();
}
class _LaufBalkenState extends State<LaufBalken>
with SingleTickerProviderStateMixin {
static const _anzahl = 3;
/// Versatz je Balken, damit sie nicht im Gleichschritt springen.
static const _versatz = [0.0, 0.35, 0.7];
late final AnimationController _takt = AnimationController(
vsync: this,
duration: const Duration(milliseconds: 900),
);
// Kein _richteTaktAus() in initState: die Entscheidung hängt an MediaQuery,
// und darauf darf man dort noch nicht zugreifen. didChangeDependencies
// läuft unmittelbar danach und erledigt es.
@override
void didUpdateWidget(LaufBalken alt) {
super.didUpdateWidget(alt);
if (alt.laeuft != widget.laeuft) _richteTaktAus();
}
@override
void didChangeDependencies() {
super.didChangeDependencies();
_richteTaktAus();
}
void _richteTaktAus() {
final ruhig = MediaQuery.disableAnimationsOf(context);
if (widget.laeuft && !ruhig) {
if (!_takt.isAnimating) _takt.repeat();
} else {
_takt.stop();
}
}
@override
void dispose() {
_takt.dispose();
super.dispose();
}
@override
Widget build(BuildContext context) {
return SizedBox(
height: widget.hoehe,
width: widget.hoehe,
child: AnimatedBuilder(
animation: _takt,
builder: (context, _) => Row(
crossAxisAlignment: CrossAxisAlignment.end,
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: [
for (var i = 0; i < _anzahl; i++)
_Balken(
anteil: _anteil(i),
hoehe: widget.hoehe,
farbe: widget.farbe,
),
],
),
),
);
}
/// Höhe eines Balkens zwischen 0,3 und 1,0. Stillstehend eine feste,
/// ungleiche Form — damit man auch pausiert erkennt, was gemeint ist.
double _anteil(int i) {
if (!_takt.isAnimating) return const [0.4, 1.0, 0.6][i];
final phase = (_takt.value + _versatz[i]) * 2 * math.pi;
return 0.3 + 0.7 * (0.5 + 0.5 * math.sin(phase));
}
}
class _Balken extends StatelessWidget {
const _Balken({
required this.anteil,
required this.hoehe,
required this.farbe,
});
final double anteil;
final double hoehe;
final Color farbe;
@override
Widget build(BuildContext context) {
return Container(
width: hoehe * 0.22,
height: hoehe * anteil,
decoration: BoxDecoration(
color: farbe,
borderRadius: BorderRadius.circular(hoehe * 0.11),
),
);
}
}
/// Das Coverbild einer Songzeile mit der Lauf-Markierung darüber.
///
/// Die Balken liegen **auf** dem Cover statt daneben: eine vierte Spalte in
/// der Zeile würde dem Titel Platz nehmen, und die Zeile spränge beim
/// Titelwechsel in der Breite.
class LaufMarkierung extends StatelessWidget {
const LaufMarkierung({
super.key,
required this.markiert,
required this.spielt,
required this.child,
this.radius = MeloRadius.element,
});
/// Dieser Titel steht in der Wiedergabe — auch pausiert.
final bool markiert;
/// Die Wiedergabe läuft tatsächlich (steuert nur die Bewegung).
final bool spielt;
final Widget child;
/// Muss zum Radius des Coverbilds darunter passen, sonst hat der Schleier
/// andere Ecken als das Bild.
final double radius;
@override
Widget build(BuildContext context) {
if (!markiert) return child;
return Stack(
alignment: Alignment.center,
children: [
child,
// Abdunkeln, damit die weißen Balken auch auf hellen Covern stehen.
Positioned.fill(
child: DecoratedBox(
decoration: BoxDecoration(
color: Colors.black.withValues(alpha: 0.55),
borderRadius: BorderRadius.circular(radius),
),
),
),
LaufBalken(laeuft: spielt),
],
);
}
}