**Der Grund, warum es diesen Server gibt.** Eine MKV mit zwei Tonspuren geht
hinein, eine MP4 mit zwei Tonspuren kommt heraus — mitsamt Sprachkennung und
Spurnamen. Im Container nachgewiesen, nicht nur im Test:
0 video h264 und
1 audio aac deu Deutsch
2 audio aac deu Audiodeskription
3 subtitle mov_text deu
Jellyfins Transcode-Endpunkt bildet je Sitzung **eine** Tonspur ab und
verliert beim Umpacken zusätzlich die Sprachkennungen. Der Plan hier hat gar
kein Feld „welche Tonspur" — es gibt nichts auszuwählen, weil alle mitgehen.
**Vorher fragen können.** `GET /files/{id}/delivery` sagt, was geschehen wird:
umgepackt oder nicht, welche Tonspuren neu gerechnet werden müssen, welche
Untertitel nicht mitkönnen. Drei Gigabyte zu laden und erst danach zu merken,
dass die falsche Tonspur drin ist, war der Anlass für das Ganze.
**Umgepackt wird auf die Platte, nicht in die Antwort.** Der bequeme Weg wäre,
ffmpeg durchzureichen. Dann kennt aber niemand die Länge im Voraus: kein
Fortschrittsbalken, kein Fortsetzen, kein Springen. Jetzt kommt beim ersten
Abruf ein 202 mit Fortschritt, danach die fertige Datei mit `Content-Length`
und `Accept-Ranges`.
**Bildbasierte Untertitel fallen weg, und das steht im Plan.** PGS passt in
keine MP4 — betrifft fast jeden Blu-ray-Rip. Stillschweigend wegzulassen
hiesse, jemanden nach Untertiteln suchen zu lassen, die der Server bewusst
entfernt hat.
---
**Zwei Funde aus echten Messungen:**
*Die Spurnamen überlebten das Umpacken nicht* — „Deutsch" kam als `null` an,
und damit wären zwei deutsche Tonspuren hinterher nicht mehr zu unterscheiden
gewesen. Ein Versuch an einer echten Datei zeigte den Grund: **MP4 nennt das
Feld `name`, Matroska nennt es `title`.** ffmpeg schreibt das eine ins andere
um; mein Leser kannte nur `title`. Keine Grenze des Formats, ein Lesefehler.
`handler_name` steht ausdrücklich nicht in der Suche — dort schreibt ffmpeg
„SoundHandler" hinein.
*Der Image-Bau brach mit Code 100 ab.* `intel-media-va-driver` gibt es für
arm64 nicht, und die Meldung verrät nicht, welches von sechs Paketen fehlt.
Die Intel-Treiber kommen jetzt nur auf amd64 dazu; `mesa-va-drivers` bedient
AMD auf beiden.
---
**Die ffmpeg-Zeile ist eine reine Funktion und wird ohne Ausführen geprüft.**
Hier liegt die Erfahrung dieser Woche: eine falsche Parameterkombination
kostete Tage, weil sie nur gegen einen echten Server zu entdecken war. Dazu
gehört die Verwechslung, vor der jetzt ein Test steht: `-c:a:1` meint die
zweite Tonspur der **Ausgabe**, nicht Spur 1 der Datei.
ffmpeg läuft als eigener Prozess, nicht als eingebundene Bibliothek — das
hält die Lizenzen getrennt und lässt einen Absturz dort den Server nicht
mitnehmen.
223 Tests grün (98 Kern, 31 Metadaten, 26 Medien, 68 Schnittstelle).
Image baut für amd64 und arm64, mit ffmpeg 6.1.1 und VAAPI.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
193 lines
7.9 KiB
C#
193 lines
7.9 KiB
C#
using System.Diagnostics;
|
|
using System.Net;
|
|
using System.Net.Http.Headers;
|
|
using System.Net.Http.Json;
|
|
using Halo.Api.Endpoints;
|
|
|
|
namespace Halo.Api.Tests;
|
|
|
|
/// <summary>Der Weg vom Scan bis zur heruntergeladenen Datei.</summary>
|
|
public class DeliveryTests
|
|
{
|
|
private string _bestand = "";
|
|
|
|
private static string? Werkzeug(string name) =>
|
|
(Environment.GetEnvironmentVariable("PATH") ?? "").Split(Path.PathSeparator)
|
|
.Select(o => o.Length == 0 ? null : Path.Combine(o, name))
|
|
.FirstOrDefault(p => p is not null && File.Exists(p));
|
|
|
|
[SetUp]
|
|
public void Anlegen()
|
|
{
|
|
if (Werkzeug("ffmpeg") is null) Assert.Ignore("ffmpeg ist auf diesem Rechner nicht installiert.");
|
|
_bestand = Directory.CreateDirectory(
|
|
Path.Combine(Path.GetTempPath(), "halo-liefern-" + Guid.CreateVersion7().ToString("N"))).FullName;
|
|
}
|
|
|
|
[TearDown]
|
|
public void Aufraeumen()
|
|
{
|
|
try { if (_bestand.Length > 0) Directory.Delete(_bestand, recursive: true); } catch (IOException) { }
|
|
}
|
|
|
|
/// <summary>Eine Datei mit zwei Tonspuren, in der gewünschten Schachtel.</summary>
|
|
private string Film(string name, string endung)
|
|
{
|
|
var ziel = Path.Combine(_bestand, $"{name}.{endung}");
|
|
var start = new ProcessStartInfo(Werkzeug("ffmpeg")!) { RedirectStandardError = true, UseShellExecute = false };
|
|
foreach (var a in new[]
|
|
{
|
|
"-y", "-loglevel", "error",
|
|
"-f", "lavfi", "-i", "testsrc=duration=1:size=160x120:rate=10",
|
|
"-f", "lavfi", "-i", "sine=frequency=440:duration=1",
|
|
"-f", "lavfi", "-i", "sine=frequency=880:duration=1",
|
|
"-map", "0:v", "-map", "1:a", "-map", "2:a",
|
|
"-metadata:s:a:0", "language=deu", "-metadata:s:a:0", "title=Deutsch",
|
|
"-metadata:s:a:1", "language=deu", "-metadata:s:a:1", "title=Audiodeskription",
|
|
"-c:v", "libx264", "-preset", "ultrafast", "-c:a", "aac", ziel,
|
|
}) start.ArgumentList.Add(a);
|
|
|
|
using var prozess = Process.Start(start)!;
|
|
var fehler = prozess.StandardError.ReadToEnd();
|
|
prozess.WaitForExit();
|
|
if (prozess.ExitCode != 0) throw new InvalidOperationException(fehler);
|
|
return ziel;
|
|
}
|
|
|
|
private async Task<(HttpClient Client, MediaFileResponse Datei)> Eingelesen()
|
|
{
|
|
var server = _server = new HaloServer();
|
|
var admin = await server.SetUpAndSignIn();
|
|
var client = server.AlsAngemeldeter(admin.Token);
|
|
|
|
var angelegt = await client.PostAsJsonAsync("/api/v1/libraries",
|
|
new CreateLibraryRequest("Prüfbestand", "Movies", _bestand));
|
|
angelegt.EnsureSuccessStatusCode();
|
|
var bibliothek = (await angelegt.Content.ReadFromJsonAsync<LibraryResponse>())!;
|
|
|
|
(await client.PostAsync($"/api/v1/libraries/{bibliothek.Id}/scan", null)).EnsureSuccessStatusCode();
|
|
for (var i = 0; i < 150; i++)
|
|
{
|
|
var stand = await client.GetFromJsonAsync<ScanStatus>($"/api/v1/libraries/{bibliothek.Id}/scan");
|
|
if (stand!.State == "finished") break;
|
|
await Task.Delay(50);
|
|
}
|
|
|
|
var filme = await client.GetFromJsonAsync<Page<MovieResponse>>("/api/v1/movies");
|
|
Assert.That(filme!.Items, Is.Not.Empty, "Der Scan hat nichts gefunden");
|
|
return (client, filme.Items[0].Files.Single());
|
|
}
|
|
|
|
private HaloServer? _server;
|
|
|
|
[TearDown]
|
|
public void ServerSchliessen() { _server?.Dispose(); _server = null; }
|
|
|
|
/// <summary>Der Scan trägt die Spuren ein — darunter die beiden Namen.</summary>
|
|
[Test]
|
|
public async Task Die_Spuren_stehen_in_der_Mediathek()
|
|
{
|
|
Film("Zwei Spuren (2020)", "mkv");
|
|
var (_, datei) = await Eingelesen();
|
|
|
|
Assert.That(datei.Container, Is.EqualTo("mkv"));
|
|
Assert.That(datei.DurationSeconds, Is.EqualTo(1).Within(0.5));
|
|
|
|
var ton = datei.Streams.Where(s => s.Kind == "Audio").ToList();
|
|
Assert.That(ton, Has.Count.EqualTo(2));
|
|
Assert.That(ton.Select(t => t.Title), Is.EqualTo(new[] { "Deutsch", "Audiodeskription" }));
|
|
}
|
|
|
|
/// <summary>Der volle Pfad des Servers geht niemanden etwas an.</summary>
|
|
[Test]
|
|
public async Task Nur_der_Dateiname_kommt_heraus_nicht_der_Pfad()
|
|
{
|
|
Film("Pfadprobe (2020)", "mkv");
|
|
var (_, datei) = await Eingelesen();
|
|
|
|
Assert.That(datei.FileName, Is.EqualTo("Pfadprobe (2020).mkv"));
|
|
Assert.That(datei.FileName, Does.Not.Contain("/"));
|
|
}
|
|
|
|
[Test]
|
|
public async Task Eine_passende_MP4_geht_unveraendert_hinaus()
|
|
{
|
|
Film("Passend (2020)", "mp4");
|
|
var (client, datei) = await Eingelesen();
|
|
|
|
var auskunft = await client.GetFromJsonAsync<DeliveryInfo>($"/api/v1/files/{datei.Id}/delivery");
|
|
Assert.That(auskunft!.Method, Is.EqualTo("directFile"));
|
|
Assert.That(auskunft.PackageState, Is.EqualTo("notNeeded"));
|
|
|
|
var antwort = await client.GetAsync($"/api/v1/files/{datei.Id}/download");
|
|
Assert.That(antwort.StatusCode, Is.EqualTo(HttpStatusCode.OK));
|
|
Assert.That(antwort.Content.Headers.ContentLength, Is.GreaterThan(0),
|
|
"Ohne Längenangabe gäbe es keinen Fortschrittsbalken");
|
|
}
|
|
|
|
/// <summary>Eine Matroska wird umgepackt — und der Client erfährt es vorher.</summary>
|
|
[Test]
|
|
public async Task Eine_Matroska_wird_angekuendigt_und_dann_umgepackt()
|
|
{
|
|
Film("Umzupacken (2020)", "mkv");
|
|
var (client, datei) = await Eingelesen();
|
|
|
|
var auskunft = await client.GetFromJsonAsync<DeliveryInfo>($"/api/v1/files/{datei.Id}/delivery");
|
|
Assert.That(auskunft!.Method, Is.EqualTo("remux"));
|
|
Assert.That(auskunft.Reasons, Does.Contain("containerUnsupported"));
|
|
Assert.That(auskunft.AudioToEncode, Is.Empty, "Beide Tonspuren passen und werden nur umgepackt");
|
|
|
|
// Der erste Abruf stösst an und wartet nicht.
|
|
var erster = await client.GetAsync($"/api/v1/files/{datei.Id}/download");
|
|
Assert.That(erster.StatusCode, Is.EqualTo(HttpStatusCode.Accepted));
|
|
|
|
HttpResponseMessage? fertig = null;
|
|
for (var i = 0; i < 150; i++)
|
|
{
|
|
fertig = await client.GetAsync($"/api/v1/files/{datei.Id}/download");
|
|
if (fertig.StatusCode != HttpStatusCode.Accepted) break;
|
|
await Task.Delay(100);
|
|
}
|
|
|
|
Assert.That(fertig!.StatusCode, Is.EqualTo(HttpStatusCode.OK));
|
|
Assert.That(fertig.Content.Headers.ContentLength, Is.GreaterThan(0));
|
|
Assert.That(fertig.Content.Headers.ContentDisposition?.FileNameStar ?? "",
|
|
Does.EndWith(".mp4"), "Heruntergeladen wird eine MP4, nicht eine MKV");
|
|
}
|
|
|
|
/// <summary>Fortsetzen nach einem Abbruch — die Forderung aus dem Fehlerbericht.</summary>
|
|
[Test]
|
|
public async Task Die_Auslieferung_versteht_Bereichsanfragen()
|
|
{
|
|
Film("Bereich (2020)", "mp4");
|
|
var (client, datei) = await Eingelesen();
|
|
|
|
var anfrage = new HttpRequestMessage(HttpMethod.Get, $"/api/v1/files/{datei.Id}/download");
|
|
anfrage.Headers.Range = new RangeHeaderValue(100, 199);
|
|
var antwort = await client.SendAsync(anfrage);
|
|
|
|
Assert.That(antwort.StatusCode, Is.EqualTo(HttpStatusCode.PartialContent));
|
|
Assert.That((await antwort.Content.ReadAsByteArrayAsync()), Has.Length.EqualTo(100));
|
|
}
|
|
|
|
[Test]
|
|
public async Task Eine_Datei_die_es_nicht_gibt_ergibt_404()
|
|
{
|
|
Film("Egal (2020)", "mp4");
|
|
var (client, _) = await Eingelesen();
|
|
|
|
var antwort = await client.GetAsync($"/api/v1/files/{Guid.CreateVersion7()}/download");
|
|
Assert.That(antwort.StatusCode, Is.EqualTo(HttpStatusCode.NotFound));
|
|
}
|
|
|
|
[Test]
|
|
public async Task Ohne_Anmeldung_gibt_es_nichts()
|
|
{
|
|
Film("Geschuetzt (2020)", "mp4");
|
|
var (_, datei) = await Eingelesen();
|
|
|
|
var antwort = await _server!.Client.GetAsync($"/api/v1/files/{datei.Id}/download");
|
|
Assert.That(antwort.StatusCode, Is.EqualTo(HttpStatusCode.Unauthorized));
|
|
}
|
|
}
|