Die App wartete auf eine fertige Datei, statt zu streamen

Gleichzeitig im Web und in der App auf Abspielen getippt: das Web lief,
die App lud dreissig Sekunden. Das war keine Ladezeit, sondern die Zeit,
die der Server braucht, um den ganzen Film einmal durchzuschreiben.

`preparePlayback` kannte nur `/files/{id}/download`. Muss die Datei
umgepackt werden, fragte es im Sekundentakt nach, bis die vollständige
MP4 auf der Platte lag — Grenze zehn Minuten. Der Endpunkt, den das Web
benutzt, ist am Server längst da; die App wusste nur nichts davon.

Jetzt zuerst `/files/{id}/stream`. Das erste Stück ist beim Umpacken in
deutlich unter einer Sekunde da. Der alte Weg bleibt als Rückfall: er ist
langsam, kommt aber ohne Sitzung aus, und eine späte Wiedergabe ist
besser als keine.

**Der Strom beginnt dort, wo man weiterschauen wollte**, und zählt
trotzdem ab null. Ohne das mitzurechnen stünde bei „Fortsetzen ab 1:32"
eine Null auf der Uhr — und genau die ginge als Fortschritt an den
Server. Also: die Zeit der Engine plus Vorlauf ist die Zeit des Films,
und der Spieler springt nicht noch einmal dorthin, wo der Server schon
steht.

**Ein Sprung aus dem Strom heraus baut ihn neu auf.** Die Abspielliste
wächst von der Einstiegsstelle vorwärts; davor und dahinter gibt es
nichts, und ein Sprung ins Leere liesse den Spieler mit einem Kreisel
stehen. Innerhalb des Erzeugten springt er weiterhin selbst — dafür eine
neue Sitzung zu starten hiesse, Sekunden zu warten, um fünf Sekunden
zurückzugehen.

**Und die Sitzung wird geschlossen.** `endPlayback` war eine leere
Methode; das passte, solange es keine Sitzung gab. Mit dem Strom läuft
sonst ein ffmpeg weiter und schreibt den Film zu Ende, während längst
niemand mehr zusieht.

Die Laufzeit kommt weiter aus den Metadaten und nicht aus der Engine:
eine wachsende Liste meldet anfangs ein paar Sekunden, und als Filmlänge
genommen stünde der Regler sofort am Ende.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Packages/FlaroKit/Sources/MediaKit/MediaPlayback.swift

@@ -112,10 +112,29 @@ public struct PlaybackTarget: Sendable, Equatable {
     /// ordnet es die Meldung keiner Wiedergabe zu.
     public let versionID: String?
 
-    public init(url: URL, sessionID: String? = nil, versionID: String? = nil) {
+    /// Ab welcher Stelle des Films dieser Strom beginnt.
+    ///
+    /// **Null heisst: der Strom ist der ganze Film.** Dann springt der
+    /// Spieler selbst, und das ist der Normalfall — bei Jellyfin immer.
+    ///
+    /// **Ein Wert darüber heisst: der Server hat schon gesprungen.** Flaros
+    /// Abspielliste wächst von der gewünschten Stelle an vorwärts; was davor
+    /// liegt, gibt es in diesem Strom nicht. Der Spieler zählt trotzdem ab
+    /// null — ohne diesen Wert ginge jede angezeigte Zeit und jede gemeldete
+    /// Stelle um den Vorlauf daneben, und ein Sprung dorthin wäre ein Sprung
+    /// ins Leere.
+    public let startOffset: Duration
+
+    public init(
+        url: URL,
+        sessionID: String? = nil,
+        versionID: String? = nil,
+        startOffset: Duration = .zero
+    ) {
         self.url = url
         self.sessionID = sessionID
         self.versionID = versionID
+        self.startOffset = startOffset
     }
 }