WebVTT in HTTP Live Streaming

ÖffnenSpeichernStreamingWeb

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
MedientypDie Playlist: application/vnd.apple.mpegurl. Ihre Segmente: text/vtt.
SpezifikationRFC 8216 (2017) und Apples HLS Authoring Specification for Apple Devices. Die Segmente sind WebVTT.
ZeitgenauigkeitMillisekunden, in den Cues der Segmente
TextkodierungUTF-8, für die Playlist und die Segmente gleichermaßen
GestaltungDie von WebVTT: kursiv, fett, unterstrichen und Farben per Klasse
PositionierungDie Cue-Einstellungen von WebVTT
SprecherDie Voice-Tags von WebVTT: <v Thom>
In ContainernKeine 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. 1 · Header

    Immer zuerst #EXTM3U. Dann die Version, die Nummer des ersten Segments und VOD: eine Sendung, deren Segmente alle vorhanden sind.

  2. 2 · Zieldauer

    Ganze Sekunden, die keine Segmentlänge, gerundet, überschreitet.

  3. 3 · Länge

    Wie lange das folgende Segment dauert, in Sekunden.

  4. 4 · Adresse

    Wo das Segment liegt: hier neben der Playlist, oder eine Webadresse.

  5. 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. 1 · Header

    WEBVTT, wie in jeder WebVTT-Datei.

  2. 2 · Timestamp-Map

    Für welchen Moment des Videos eine Cue-Zeit steht.

  3. 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

In den Segmenten erhalten
  • 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
Kein Platz dafür
  • 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- oder https-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

Subtitlds Exportdialog mit gewähltem HLS, Sprecher als Voice-Tags, Segmente von 6 Sekunden und die Timestamp-Map bei MPEGTS 900000

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-MapMPEGTS:900000, 10 Sekunden, wo die meisten Encoder die Uhr eines Streams starten, oder MPEGTS: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

2009

Apple veröffentlichte HTTP Live Streaming im Mai 2009. Nach Jahren als Internet-Draft erschien es im August 2017 als RFC 8216.

26,5 h

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.

6 s

Apples Authoring-Spezifikation sagt, Zieldauern sollten 6 Sekunden betragen und WebVTT-Untertitel müssten eine Timestamp-Map haben.

Verwandte Formate

Eine .m3u8-Datei zu korrigieren?

Öffnen Sie sie in Subtitld mit dem Video und passen Sie die Zeiten an der Wellenform an.

Subtitld herunterladen