WebVTT in HTTP Live Streaming
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édia | La playlist : application/vnd.apple.mpegurl. Ses segments : text/vtt. |
| Spécification | RFC 8216 (2017), et la HLS Authoring Specification for Apple Devices d'Apple. Les segments sont du WebVTT. |
| Précision temporelle | Millisecondes, dans les cues des segments |
| Encodage du texte | UTF-8, pour la playlist comme pour les segments |
| Style | Celui de WebVTT : italique, gras, soulignement, et couleurs par classe |
| Positionnement | Les réglages de cue de WebVTT |
| Locuteurs | Les balises de voix de WebVTT : <v Thom> |
| Dans les conteneurs | Aucun 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 · En-tête
#EXTM3Uen premier, toujours. Puis la version, le numéro du premier segment, etVOD: une émission dont tous les segments sont déjà là. - 2 · Durée cible
Un nombre entier de secondes qu'aucune durée de segment, arrondie, ne dépasse.
- 3 · Durée
La durée du segment qui suit, en secondes.
- 4 · Adresse
L'endroit où se trouve le segment : ici à côté de la playlist, ou une adresse web.
- 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 · En-tête
WEBVTT, comme dans tout fichier WebVTT. - 2 · Table d'horodatage
À quel moment de la vidéo correspond un temps de cue.
- 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
- 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
- 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
httpouhttps, 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
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'horodatage
MPEGTS:900000, 10 secondes, là où la plupart des encodeurs démarrent l'horloge d'un flux, ouMPEGTS: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
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.
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.
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
Ouvrez-le dans Subtitld avec la vidéo et recalez-le sur la forme d'onde.