Ton und Bild: ein Versatz zum Einstellen, und zwei gemessene Fehler weniger

Du meldest Ton, der drei, vier Sekunden neben dem Bild liegt.
**Nachstellen konnte ich es nicht** — und das sage ich lieber, als eine
Vermutung als Befund zu verkaufen.

Gemessen habe ich alle vier Wege, jeweils mit ffprobe am Ergebnis, erster
Zeitstempel je Spur:

| Weg | Bild ab | Ton ab |
|---|---|---|
| Umpacken, ab 0 | 0,021 | 0,000 |
| Umpacken, ab 12 | 0,000 | 1,979 |
| Umkodieren, ab 0 | 0,021 | 0,000 |
| Umkodieren, ab 12 | 0,021 | 0,000 |

Alle vier sind **zueinander richtig**. Auch eine Quelle mit einem echten
Loch in der Tonspur blieb ausgerichtet. Die naheliegende Erklärung — `-ss`
vor `-i` mit kopiertem Bild und neu gerechnetem Ton — ist damit widerlegt.

**Zwei echte Fehler hat dieselbe Messung aber gefunden**, und beide sehen
aus wie „um Sekunden daneben":

Zeile zwei der Tabelle. Beim Umpacken fängt das Bild beim Schlüsselbild
*vor* dem Sprung an, der Ton genau beim Sprung — bei Sekunde 12 also zwei
Sekunden Bild **ohne Ton** am Anfang. Zueinander stimmen beide, aber jeder
Spieler darf diese Lücke deuten, wie er will. Und der Server meldete dem
Spieler „beginnt bei 12", obwohl er bei 10 beginnt: die Uhr, die
Zeitleiste und der gespeicherte Stand lagen um diesen Unterschied daneben.

Beides geht weg, indem der Sprung **auf das Schlüsselbild gerundet** wird
und derselbe Wert zurückgemeldet wird. Dann fangen Bild und Ton zusammen
an, es gibt keine Stille davor, und die Uhr stimmt. Beim Umkodieren
entfällt das Runden — dort schneidet das neu gerechnete Bild genau.

**Und: ffmpeg durfte bisher nichts sagen.** `-loglevel error` versteckt
genau die Meldungen, die einen Tonversatz ankündigen, und der
Fehlerkanal wurde bei Rückgabewert 0 weggeworfen. Jetzt steht er auf
`warning`, und Warnungen landen auch bei einem geglückten Lauf im
Protokoll. Wenn es bei dir wieder auftritt, steht diesmal etwas da.

**Der Versatz zum Einstellen** sitzt im Tonmenü des Spielers: „Später"
und „Früher" in Hundertmillisekundenschritten, bis ±5 s, dazu
„Zurücksetzen". Gemerkt wird er **je Datei in diesem Browser** — ein
Versatz ist meist eine Eigenschaft der Datei, kann aber auch an der
Anlage liegen, und über Bluetooth stimmt etwas anderes als am Fernseher.

Verschoben wird serverseitig: die Datei wird ein zweites Mal mit
`-itsoffset` geöffnet und von dort nur der Ton genommen. Mit einer
Eingabe verschöbe sich beides gemeinsam. Der Preis: der Strom startet neu,
und eine durchgereichte Datei muss dafür umgepackt werden — ohne ffmpeg
lässt sich nichts verschieben.

Zwei neue Läufe halten das fest: dass Bild und Ton zusammen anfangen, und
dass ein halbe-Sekunde-Versatz den Ton um eine halbe Sekunde verschiebt
und das Bild gar nicht. Der Sprungtest daneben lief bisher genau durch
diesen Fall und sah nur nach, ob überhaupt Segmente entstehen.

Ein Test musste umgeschrieben werden: er stand auf „Einstiegspunkt ist
genau 2" und hielt damit die falsche Meldung fest.

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

server/tests/Flaro.Media.Tests/HlsLaufTests.cs

@@ -43,13 +43,15 @@ public class HlsLaufTests
         AudioCodecs: new HashSet<string>(StringComparer.OrdinalIgnoreCase) { "aac", "mp3" });
 
     /// <summary>Führt die gebaute Zeile aus und gibt den Zielordner zurück.</summary>
-    private string Laufen(string quelle, int? hoehe = null, int? tonspur = null, double ab = 0)
+    private string Laufen(
+        string quelle, int? hoehe = null, int? tonspur = null, double ab = 0, double tonversatz = 0)
     {
         var spuren = Spuren(quelle);
         var ziel = Directory.CreateDirectory(Path.Combine(_ordner, "aus" + Guid.NewGuid().ToString("N")[..6])).FullName;
 
         var plan = Stromentscheid.Fuer(Path.GetExtension(quelle).TrimStart('.'), spuren, Browser, hoehe);
-        var argumente = HlsArgumente.Fuer(new Stromanfrage(quelle, ziel, spuren, plan, tonspur, ab));
+        var argumente = HlsArgumente.Fuer(
+            new Stromanfrage(quelle, ziel, spuren, plan, tonspur, ab, Tonversatz: tonversatz));
 
         var start = new ProcessStartInfo(Testdateien.Suchen("ffmpeg")!)
         {
@@ -190,6 +192,54 @@ public class HlsLaufTests
         Assert.That(Directory.GetFiles(ziel, "*.m4s"), Is.Not.Empty);
     }
 
+    /// <summary>Bild und Ton fangen an derselben Stelle an.</summary>
+    ///
+    /// <remarks>
+    /// <para>
+    /// <b>Die Quelle hat genau ein Schlüsselbild, bei null.</b> Ein Sprung auf
+    /// Sekunde 4 ist damit der schlimmste Fall: das kopierte Bild muss ganz
+    /// vorn anfangen, der neu gerechnete Ton könnte bei 4 anfangen — vier
+    /// Sekunden stummes Bild, und eine Uhr, die um vier Sekunden danebenliegt.
+    /// </para>
+    /// <para>
+    /// Gemessen an einer Quelle mit Schlüsselbildern alle fünf Sekunden und
+    /// einem Sprung auf Sekunde 12 war es genau so: Bild ab 0, Ton ab 1,98.
+    /// Deshalb rundet der Koordinator den Sprung auf das Schlüsselbild —
+    /// hier wird geprüft, dass die Zeile das auch verträgt.
+    /// </para>
+    /// </remarks>
+    [Test]
+    public void Bild_und_Ton_fangen_zusammen_an()
+    {
+        var quelle = Path.Combine(_ordner, "lang.mkv");
+        Lang(quelle);
+
+        // Auf dem Schlüsselbild, so wie der Koordinator es rundet.
+        var (bild, ton) = Anfang(Laufen(quelle, ab: 0));
+
+        Assert.That(Math.Abs(bild - ton), Is.LessThan(0.2),
+            $"Bild beginnt bei {bild}, Ton bei {ton} — das hört man.");
+    }
+
+    /// <summary>Der Tonversatz verschiebt den Ton, nicht das Bild.</summary>
+    [Test]
+    public void Ein_Tonversatz_verschiebt_nur_den_Ton()
+    {
+        var quelle = Path.Combine(_ordner, "lang.mkv");
+        Lang(quelle);
+
+        var (bildOhne, tonOhne) = Anfang(Laufen(quelle));
+        var (bildMit, tonMit) = Anfang(Laufen(quelle, tonversatz: 0.5));
+
+        Assert.Multiple(() =>
+        {
+            Assert.That(Math.Abs(bildMit - bildOhne), Is.LessThan(0.1),
+                "Das Bild darf sich dabei nicht bewegen.");
+            Assert.That(tonMit - tonOhne, Is.EqualTo(0.5).Within(0.1),
+                "Eine halbe Sekunde später heisst eine halbe Sekunde später.");
+        });
+    }
+
     private static void Gross(string ziel) => Werkzeug(
     [
         "-y", "-loglevel", "error",
@@ -199,6 +249,39 @@ public class HlsLaufTests
         ziel,
     ]);
 
+    /// <summary>Wo Bild und Ton im Ergebnis anfangen — in Sekunden.</summary>
+    ///
+    /// <remarks>
+    /// <b>Das ist die Prüfung, die gefehlt hat.</b> Der Sprungtest daneben sah
+    /// nur nach, ob überhaupt Segmente entstehen — und lief dabei genau durch
+    /// den Fall, der schiefgehen kann, ohne hinzusehen.
+    /// </remarks>
+    private static (double Bild, double Ton) Anfang(string ziel)
+    {
+        double Erste(string spur)
+        {
+            var start = new ProcessStartInfo(Testdateien.Suchen("ffprobe")!)
+            {
+                ArgumentList =
+                {
+                    "-v", "error", "-select_streams", spur,
+                    "-show_entries", "packet=pts_time", "-of", "csv=p=0",
+                    Path.Combine(ziel, HlsArgumente.Playlist),
+                },
+                RedirectStandardOutput = true,
+                UseShellExecute = false,
+            };
+            using var prozess = Process.Start(start)!;
+            var text = prozess.StandardOutput.ReadToEnd();
+            prozess.WaitForExit();
+
+            var erste = text.Split('\n', StringSplitOptions.RemoveEmptyEntries)[0].TrimEnd(',', '\r');
+            return double.Parse(erste, System.Globalization.CultureInfo.InvariantCulture);
+        }
+
+        return (Erste("v"), Erste("a"));
+    }
+
     private static void Lang(string ziel) => Werkzeug(
     [
         "-y", "-loglevel", "error",