WebVTT in HTTP Live Streaming

OuvrirEnregistrerStreamingWeb

La façon dont HTTP Live Streaming d'Apple transporte les sous-titres : une playlist, et les fichiers WebVTT qu'elle énumère, chacun couvrant quelques secondes de l'émission. Un lecteur les récupère au fil de la lecture, à côté des segments de la vidéo.

En bref

Extension.m3u8
Type de médiaLa playlist : application/vnd.apple.mpegurl. Ses segments : text/vtt.
SpécificationRFC 8216 (2017), et la HLS Authoring Specification for Apple Devices d'Apple. Les segments sont du WebVTT.
Précision temporelleMillisecondes, dans les cues des segments
Encodage du texteUTF-8, pour la playlist comme pour les segments
StyleCelui de WebVTT : italique, gras, soulignement, et couleurs par classe
PositionnementLes réglages de cue de WebVTT
LocuteursLes balises de voix de WebVTT : <v Thom>
Dans les conteneursAucun pour le WebVTT : des fichiers texte sur un serveur web. Les sous-titres IMSC en HLS arrivent en MP4 fragmenté.

Anatomie d'une playlist

Une liste de segments, chacun avec sa durée. Les sous-titres sont dans les fichiers qu'elle nomme.

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-PLAYLIST-TYPE:VOD
#EXTINF:6.000,
movie_segments/segment00000.vtt
#EXTINF:6.000,
movie_segments/segment00001.vtt
#EXTINF:2.000,
movie_segments/segment00002.vtt
#EXT-X-ENDLIST
  1. 1 · En-tête

    #EXTM3U en premier, toujours. Puis la version, le numéro du premier segment, et VOD : une émission dont tous les segments sont déjà là.

  2. 2 · Durée cible

    Un nombre entier de secondes qu'aucune durée de segment, arrondie, ne dépasse.

  3. 3 · Durée

    La durée du segment qui suit, en secondes.

  4. 4 · Adresse

    L'endroit où se trouve le segment : ici à côté de la playlist, ou une adresse web.

  5. 5 · Fin

    Plus rien ne viendra. Un flux en direct l'omet et continue d'ajouter des segments.

Anatomie d'un segment

Chaque segment est un fichier WebVTT à part entière, avec une ligne de plus dans son en-tête.

WEBVTT
X-TIMESTAMP-MAP=LOCAL:00:00:00.000,MPEGTS:900000
 
00:00:04.000 --> 00:00:07.500
<v Celia>You're a jerk,
Thom.
 
00:00:08.000 --> 00:00:09.600
<v Thom><i>Celia!</i>
  1. 1 · En-tête

    WEBVTT, comme dans tout fichier WebVTT.

  2. 2 · Table d'horodatage

    À quel moment de la vidéo correspond un temps de cue.

  3. 3 · Cues

    Chaque cue affichée pendant le segment, chacune avec son temps complet, même la partie hors du segment.

Voici le deuxième segment, de 6 à 12 secondes. Sa première cue a commencé dans le premier segment, à 4 secondes, et figure dans les deux : un lecteur qui démarre ici l'affiche quand même.

La table d'horodatage

Les images de la vidéo portent des horodatages MPEG-2, comptés sur une horloge de 90,000 ticks par seconde. La table relie les deux horloges :

Partie Ce qu'elle dit
LOCAL:00:00:00.000 Un temps de cue dans ce fichier
MPEGTS:900000 L'horodatage de la vidéo à ce moment : 900,000 ticks, 10 secondes

De nombreux encodeurs démarrent l'horloge d'un flux à 10 secondes, d'où la valeur habituelle 900000. Avec la table, une cue à 00:00:04.000 s'affiche avec l'image horodatée 1,260,000. Un segment sans table est lu comme faisant correspondre 0 à 0.

Une table erronée décale tous les sous-titres. Si l'horloge de la vidéo commence à 10 secondes et que la table indique 0, un lecteur affiche les sous-titres avec 10 secondes de retard, ou pas du tout. Écrivez la valeur qu'a utilisée l'encodeur de la vidéo.

Les sous-titres dans un flux complet

La playlist principale d'un flux énumère ses variantes (renditions) : la vidéo en plusieurs tailles, l'audio, et les sous-titres dans chaque langue, chacune avec sa propre playlist.

#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",NAME="English",LANGUAGE="en",DEFAULT=YES,URI="en.m3u8"
Attribut Ce qu'il contient
TYPE SUBTITLES
LANGUAGE La langue des sous-titres, sous forme de balise BCP 47
DEFAULT YES pour celle affichée lorsque le spectateur n'en a choisi aucune
URI La playlist propre aux sous-titres, comme celle ci-dessus

HLS ou fichier WebVTT ?

Fichier WebVTT HLS
Fichiers Un seul Une playlist et un segment toutes les quelques secondes
Affiché par Le <track> d'une page web, les lecteurs Les lecteurs HLS : Safari, iPhone, Apple TV, et hls.js sur le web
Relié à la vidéo par Des temps depuis le début La table d'horodatage, par rapport aux horodatages de la vidéo
Direct — Des segments ajoutés au fil de l'émission

HLS dans Subtitld

Conservé dans les segments
  • Le texte et les sauts de ligne de chaque sous-titre
  • Italique, gras, soulignement et couleur, comme les conserve WebVTT
  • L'endroit où il se place, sous forme de réglages de cue
  • Les locuteurs, sous forme de balises de voix
  • Début et fin, à la milliseconde
Aucun moyen de les garder
  • La langue : Subtitld écrit la playlist des sous-titres, pas une playlist principale qui la nomme
  • Les traductions à côté de l'original
  • Les doublages, les visages et les couleurs des locuteurs

Enregistrez un projet .usfx pour les conserver.

Ouvrir une playlist HLS

Ouvrez le fichier .m3u8. Subtitld :

  • suit une playlist principale jusqu'à ses sous-titres : la variante dans la langue du projet, sinon celle par défaut, sinon la première ;
  • lit chaque segment que la playlist énumère, à côté d'elle ou à une adresse http ou https, ainsi que la partie d'un fichier que désigne une plage d'octets ;
  • lit les segments comme du WebVTT, et décale chacun selon sa table d'horodatage, pour que le premier instant du flux soit 0 ;
  • garde une seule fois une cue répétée dans les segments qu'elle couvre, et réunit une cue qu'un segmenteur a coupée en deux à la limite d'un segment ;
  • lit les segments IMSC en MP4 fragmenté, tels que les transporte le CMAF ;
  • prend la langue de la variante comme celle du projet.

Un fichier qui ne commence pas par #EXTM3U, ou une playlist sans sous-titres, le signale.

Exporter en HLS

La boîte de dialogue d'export de Subtitld avec HLS choisi, les locuteurs en balises de voix, des segments de 6 secondes et la table d'horodatage à MPEGTS 900000

Exporter, puis Sous-titres et HLS, propose :

  • TexteL'original, une traduction, ou les deux, la traduction en dessous.
  • Noms des locuteursOmis, avant le texte (Thom : …), ou sous forme de balises de voix (<v Thom>).
  • Mise en formeConservée, ou retirée.
  • Décaler les tempsChaque sous-titre plus tôt ou plus tard d'un même écart.
  • Durée des segments2, 4, 6 ou 10 secondes. 6 est ce que recommande Apple.
  • Table d'horodatageMPEGTS:900000, 10 secondes, là où la plupart des encodeurs démarrent l'horloge d'un flux, ou MPEGTS:0.

Subtitld écrit la playlist, version 3, et un dossier à côté nommé d'après elle (movie.m3u8, movie_segments) avec les segments, segment00000.vtt et suivants. Tous les segments ont la même durée sauf le dernier, et la même table, si bien que leurs temps de cue sont ceux de l'émission. Les segments couvrent toute la durée de la vidéo, segments vides compris, ou celle des sous-titres en l'absence de vidéo. Réenregistrer remplace les segments du dossier.

Ajoutez la playlist à la playlist principale de votre flux avec une ligne #EXT-X-MEDIA:TYPE=SUBTITLES, sa langue et son adresse.

Anecdotes

2009

Apple a lancé HTTP Live Streaming en mai 2009. Il a été publié sous le nom de RFC 8216 en août 2017, après des années à l'état d'Internet-Draft.

26.5 h

La durée pendant laquelle l'horloge à 90,000 ticks des horodatages MPEG-2 tourne avant que ses 33 bits ne repassent à zéro. La RFC 8216 demande aux lecteurs de s'en accommoder, les temps de cue continuant, eux.

6 s

La spécification d'authoring d'Apple indique que les durées cibles devraient être de 6 secondes, et que les sous-titres WebVTT doivent avoir une table d'horodatage.

Formats associés

Un fichier .m3u8 à corriger ?

Ouvrez-le dans Subtitld avec la vidéo et recalez-le sur la forme d'onde.

Télécharger Subtitld