WebVTT in HTTP Live Streaming
Wie Apples HTTP Live Streaming Untertitel trägt: eine Playlist und die WebVTT-Dateien, die sie aufführt, jede ein paar Sekunden der Sendung. Ein Player lädt sie beim Abspielen, neben den eigenen Segmenten des Videos.
Auf einen Blick
| Dateiendung | .m3u8 |
|---|---|
| Medientyp | Die Playlist: application/vnd.apple.mpegurl. Ihre Segmente: text/vtt. |
| Spezifikation | RFC 8216 (2017) und Apples HLS Authoring Specification for Apple Devices. Die Segmente sind WebVTT. |
| Zeitgenauigkeit | Millisekunden, in den Cues der Segmente |
| Textkodierung | UTF-8, für die Playlist und die Segmente gleichermaßen |
| Gestaltung | Die von WebVTT: kursiv, fett, unterstrichen und Farben per Klasse |
| Positionierung | Die Cue-Einstellungen von WebVTT |
| Sprecher | Die Voice-Tags von WebVTT: <v Thom> |
| In Containern | Keine für WebVTT: reine Textdateien auf einem Webserver. IMSC-Untertitel in HLS kommen in fragmentiertem MP4. |
Aufbau einer Playlist
Eine Liste von Segmenten, jedes mit seiner Länge. Die Untertitel stehen in den Dateien, die sie nennt.
#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 · Header
Immer zuerst
#EXTM3U. Dann die Version, die Nummer des ersten Segments undVOD: eine Sendung, deren Segmente alle vorhanden sind. - 2 · Zieldauer
Ganze Sekunden, die keine Segmentlänge, gerundet, überschreitet.
- 3 · Länge
Wie lange das folgende Segment dauert, in Sekunden.
- 4 · Adresse
Wo das Segment liegt: hier neben der Playlist, oder eine Webadresse.
- 5 · Ende
Es kommt nichts mehr. Ein Livestream lässt es weg und fügt weiter Segmente hinzu.
Aufbau eines Segments
Jedes Segment ist eine eigene WebVTT-Datei, mit einer Zeile mehr im Header.
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 · Header
WEBVTT, wie in jeder WebVTT-Datei. - 2 · Timestamp-Map
Für welchen Moment des Videos eine Cue-Zeit steht.
- 3 · Cues
Jeder während des Segments gezeigte Cue, jeder mit seiner ganzen Zeit, auch dem Teil außerhalb des Segments.
Dies ist das zweite Segment, von 6 bis 12 Sekunden. Sein erster Cue begann im ersten Segment, bei 4 Sekunden, und steht in beiden: Ein Player, der hier beginnt, zeigt ihn trotzdem.
Die Timestamp-Map
Die Frames des Videos tragen MPEG-2-Zeitstempel, gezählt in einem Takt von 90.000 Ticks pro Sekunde. Die Map verbindet die beiden Uhren:
| Teil | Was er sagt |
|---|---|
LOCAL:00:00:00.000 |
Eine Cue-Zeit in dieser Datei |
MPEGTS:900000 |
Der Zeitstempel des Videos zu dieser Zeit: 900.000 Ticks, 10 Sekunden |
Viele Encoder starten die Uhr eines Streams bei 10 Sekunden, daher ist 900000 der übliche Wert. Mit der Map wird ein Cue bei 00:00:04.000 mit dem Frame gezeigt, der den Stempel 1.260.000 trägt. Ein Segment ohne Map wird so gelesen, als bilde es 0 auf 0 ab.
Eine falsche Map verschiebt jeden Untertitel. Wenn die Uhr des Videos bei 10 Sekunden beginnt und die Map 0 sagt, zeigt ein Player die Untertitel 10 Sekunden zu spät oder gar nicht. Schreiben Sie den Wert, den der Encoder des Videos verwendet hat.
Untertitel in einem ganzen Stream
Die Haupt-Playlist eines Streams führt seine Renditions auf: das Video in mehreren Größen, das Audio und die Untertitel in jeder Sprache, jede mit eigener Playlist.
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",NAME="English",LANGUAGE="en",DEFAULT=YES,URI="en.m3u8"
| Attribut | Was es enthält |
|---|---|
TYPE |
SUBTITLES |
LANGUAGE |
Die Sprache der Untertitel, als BCP-47-Tag |
DEFAULT |
YES für die, die gezeigt wird, wenn der Zuschauer keine gewählt hat |
URI |
Die eigene Playlist der Untertitel, wie die oben |
HLS oder eine WebVTT-Datei?
| WebVTT-Datei | HLS | |
|---|---|---|
| Dateien | Eine | Eine Playlist und alle paar Sekunden ein Segment |
| Angezeigt von | Dem <track> einer Webseite, Playern |
HLS-Playern: Safari, iPhone, Apple TV, und hls.js im Web |
| Mit dem Video verbunden durch | Zeiten ab dem Beginn | Die Timestamp-Map, gegen die eigenen Zeitstempel des Videos |
| Live | — | Segmente, die im Lauf der Sendung hinzukommen |
HLS in Subtitld
- Text und Zeilenumbrüche jedes Untertitels
- Kursiv, fett, unterstrichen und Farbe, so wie WebVTT sie hält
- Wo er steht, als Cue-Einstellungen
- Sprecher, als Voice-Tags
- Beginn und Ende, auf die Millisekunde genau
- Die Sprache: Subtitld schreibt die Playlist der Untertitel, keine Haupt-Playlist, die sie nennt
- Übersetzungen neben dem Original
- Synchronisationen, Gesichter und Farben der Sprecher
Speichern Sie ein .usfx-Projekt, um sie zu behalten.
Eine HLS-Playlist öffnen
Öffnen Sie die .m3u8-Datei. Subtitld:
- folgt einer Haupt-Playlist zu ihren Untertiteln: der Rendition in der Sprache des Projekts, sonst der Standard-Rendition, sonst der ersten;
- liest jedes Segment, das die Playlist aufführt, neben ihr oder unter einer
http- oderhttps-Adresse, und den Teil einer Datei, den ein Byte-Bereich nennt; - liest die Segmente als WebVTT und verschiebt jedes um seine Timestamp-Map, sodass der erste Moment des Streams 0 ist;
- behält einen Cue, der in den Segmenten wiederholt wird, die er überspannt, einmal, und fügt einen Cue zusammen, den ein Segmentierer an der Grenze eines Segments geteilt hat;
- liest IMSC-Segmente in fragmentiertem MP4, wie CMAF sie trägt;
- übernimmt die Sprache der Rendition als die des Projekts.
Eine Datei, die nicht mit #EXTM3U beginnt, oder eine Playlist ohne Untertitel meldet das.
HLS exportieren
Export, dann Untertitel und HLS, bietet:
- TextDas Original, eine Übersetzung oder beides, die Übersetzung darunter.
- SprechernamenWeggelassen, vor dem Text (Thom: …) oder als Voice-Tags (
<v Thom>). - FormatierungBeibehalten oder entfernt.
- Zeiten verschiebenJeder Untertitel um denselben Betrag früher oder später.
- Segmentlänge2, 4, 6 oder 10 Sekunden. 6 empfiehlt Apple.
- Timestamp-Map
MPEGTS:900000, 10 Sekunden, wo die meisten Encoder die Uhr eines Streams starten, oderMPEGTS:0.
Subtitld schreibt die Playlist, Version 3, und daneben einen nach ihr benannten Ordner (movie.m3u8, movie_segments) mit den Segmenten, segment00000.vtt und weiter. Jedes Segment außer dem letzten ist gleich lang und hat dieselbe Map, sodass seine Cue-Zeiten die der Sendung sind. Die Segmente laufen so lange wie das Video, leere eingeschlossen, oder so lange wie die Untertitel, wenn es kein Video gibt. Erneutes Speichern ersetzt die Segmente im Ordner.
Fügen Sie die Playlist mit einer Zeile #EXT-X-MEDIA:TYPE=SUBTITLES, ihrer Sprache und ihrer Adresse zur Haupt-Playlist Ihres Streams hinzu.
Wissenswertes
Apple veröffentlichte HTTP Live Streaming im Mai 2009. Nach Jahren als Internet-Draft erschien es im August 2017 als RFC 8216.
So lange läuft der 90.000-Tick-Takt der MPEG-2-Zeitstempel, bevor seine 33 Bit auf null überlaufen. RFC 8216 verlangt von Playern, damit umzugehen, wenn das passiert und die Cue-Zeiten weiterlaufen.
Apples Authoring-Spezifikation sagt, Zieldauern sollten 6 Sekunden betragen und WebVTT-Untertitel müssten eine Timestamp-Map haben.
Verwandte Formate
Öffnen Sie sie in Subtitld mit dem Video und passen Sie die Zeiten an der Wellenform an.