Enregistrements : corriger le démarrage de la lecture

La lecture d'un enregistrement démarrait au milieu du programme et se
coupait aussitôt ; il fallait relancer une deuxième fois pour qu'elle
tienne.

Cause principale, introduite avec le passage de la playlist en `EVENT` :
tant que le transcodage n'est pas terminé, la playlist n'a pas
d'`EXT-X-ENDLIST`, et hls.js traite alors tout contenu comme du direct.
Sans `startPosition` explicite il démarre au « bord du direct » — donc
collé au front d'encodage, sans la moindre avance de segments. D'où un
départ en plein milieu, puis une coupure immédiate. Au second essai, le
transcodage était terminé (ENDLIST présent, contenu traité en VOD) et
tout se passait bien.

Hors direct : `startPosition: 0` (ou la position de reprise), rattrapage
de latence neutralisé (il accélérait la lecture puis forçait un saut en
avant vers un direct inexistant), et délai d'attente de playlist porté de
10 s à 45 s — une session FFmpeg qui démarre n'est plus prise pour un
manifeste mort.

Cause de fond : la lecture ré-encodait la vidéo. Or la capture se fait en
`-c copy`, donc le fichier contient le codec de la chaîne, presque
toujours du H.264, directement lisible en HLS. Le ré-encodage tenait à
peine le temps réel en 1080p, ce qui laissait le lecteur courir après
l'encodeur en permanence. La vidéo est désormais copiée telle quelle
quand elle est en H.264 (seul l'audio est converti en AAC) : la
segmentation va à la vitesse du disque, l'enregistrement devient
navigable en quelques secondes et les sauts ne redémarrent presque plus
jamais FFmpeg. Les codecs que le navigateur ne sait pas lire (HEVC,
MPEG-2…) restent ré-encodés.

En complément :
- le serveur attend trois segments d'avance avant de servir la playlist,
  et sert ce qu'il a plutôt qu'une erreur si le délai expire ;
- le lecteur de bureau réessaie seul jusqu'à 3 fois, comme le lecteur
  mobile le faisait déjà ;
- `XFPlayer.destroy()` retire ses écouteurs : sans ça, une relance
  laissait l'instance précédente réagir aux commandes du parent et
  republier des positions périmées ;
- les appels ffprobe passent par `MediaProbe`, qui mémorise durée et
  codec tant que le fichier ne change pas.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T1A6WRnoktWcT7ZG4b2rbC
This commit is contained in:
Claude committed 2026-09-10 17:48:02 +00:00
1 parent b95d72fe80
commit fa8eed38f2
7 files changed
+277 -102

No files matched your search

+29 -6
View File
@@ -143,22 +143,40 @@ class FfmpegSessionManager {
}
}
/// Waits until the session's playlist references at least one segment.
/// Fails fast when the process dies before producing output, returning
/// the recent stderr for diagnostics.
/// Waits until the session's playlist references at least [minSegments]
/// segments. Fails fast when the process dies before producing output,
/// returning the recent stderr for diagnostics.
///
/// [minSegments] > 1 donne au lecteur une avance de démarrage : servir la
/// playlist dès le premier segment le fait partir avec 4 s de marge sur un
/// encodeur qui n'a pas fini — la moindre hésitation coupe la lecture. La
/// playlist déjà close (`#EXT-X-ENDLIST`) est renvoyée telle quelle, quel
/// que soit son nombre de segments : rien de plus n'arrivera.
Future<({bool ready, String? error})> waitForPlaylist(
FfmpegSession session, {
Duration timeout = const Duration(seconds: 30),
int minSegments = 1,
}) async {
final playlistFile = File('${session.dir.path}/playlist.m3u8');
final deadline = DateTime.now().add(timeout);
while (DateTime.now().isBefore(deadline)) {
if (playlistFile.existsSync() &&
playlistFile.readAsStringSync().contains('.ts')) {
return (ready: true, error: null);
if (playlistFile.existsSync()) {
final content = playlistFile.readAsStringSync();
final segments = '.ts'.allMatches(content).length;
if (segments >= minSegments ||
(segments > 0 && content.contains('#EXT-X-ENDLIST'))) {
return (ready: true, error: null);
}
}
if (session.exited) {
// Un encodeur qui s'est terminé proprement en ayant produit moins de
// segments que demandé a simplement fini : c'est un succès.
if (session.exitCode == 0 &&
playlistFile.existsSync() &&
playlistFile.readAsStringSync().contains('.ts')) {
return (ready: true, error: null);
}
return (
ready: false,
error: 'FFmpeg exited (${session.exitCode}): '
@@ -169,6 +187,11 @@ class FfmpegSessionManager {
// latence pure entre la disponibilité de la playlist et sa réponse.
await Future.delayed(const Duration(milliseconds: 100));
}
// Le délai est écoulé : mieux vaut servir ce qui existe que rien.
if (playlistFile.existsSync() &&
playlistFile.readAsStringSync().contains('.ts')) {
return (ready: true, error: null);
}
return (ready: false, error: 'Timeout waiting for transcoder');
}