WebVTT in HTTP Live Streaming

OpenenOpslaanStreamingWeb

Hoe HTTP Live Streaming van Apple ondertitels draagt: een afspeellijst, en de WebVTT-bestanden die ze noemt, elk een paar seconden van het programma. Een speler haalt ze op tijdens het afspelen, naast de eigen segmenten van de video.

In één oogopslag

Extensie.m3u8
MediatypeDe afspeellijst: application/vnd.apple.mpegurl. De segmenten: text/vtt.
SpecificatieRFC 8216 (2017), en de HLS Authoring Specification for Apple Devices van Apple. De segmenten zijn WebVTT.
TijdsprecisieMilliseconden, in de cues van de segmenten
TekstcoderingUTF-8, voor de afspeellijst en de segmenten gelijk
OpmaakDie van WebVTT: cursief, vet, onderstreping, en kleuren via klassen
PositioneringDe cue-instellingen van WebVTT
SprekersDe voice-tags van WebVTT: <v Thom>
In containersGeen voor WebVTT: platte tekstbestanden op een webserver. IMSC-ondertitels in HLS komen in gefragmenteerde MP4.

Opbouw van een afspeellijst

Een lijst segmenten, elk met zijn duur. De ondertitels staan in de bestanden die ze noemt.

#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 · Kop

    #EXTM3U eerst, altijd. Dan de versie, het nummer van het eerste segment, en VOD: een programma waarvan alle segmenten er zijn.

  2. 2 · Doelduur

    Hele seconden waar de afgeronde duur van geen enkel segment overheen gaat.

  3. 3 · Duur

    Hoe lang het segment erna duurt, in seconden.

  4. 4 · Adres

    Waar het segment staat: hier naast de afspeellijst, of een webadres.

  5. 5 · Einde

    Er komt niets meer. Een livestream laat het weg en blijft segmenten toevoegen.

Opbouw van een segment

Elk segment is een eigen WebVTT-bestand, met één regel extra in de kop.

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 · Kop

    WEBVTT, zoals in elk WebVTT-bestand.

  2. 2 · Timestamp map

    Voor welk moment van de video een cue-tijd staat.

  3. 3 · Cues

    Elke cue die tijdens het segment wordt getoond, elk met zijn hele tijd, ook het deel buiten het segment.

Dit is het tweede segment, van 6 tot 12 seconden. De eerste cue begon in het eerste segment, bij 4 seconden, en staat in beide: een speler die hier begint, toont hem toch.

De timestamp map

De frames van de video dragen MPEG-2-tijdstempels, geteld op een klok van 90.000 ticks per seconde. De map koppelt de twee klokken aan elkaar:

Deel Wat het zegt
LOCAL:00:00:00.000 Een cue-tijd in dit bestand
MPEGTS:900000 Het tijdstempel van de video op dat moment: 900.000 ticks, 10 seconden

Veel encoders laten de klok van een stream bij 10 seconden beginnen, dus 900000 is de gebruikelijke waarde. Met de map wordt een cue op 00:00:04.000 getoond bij het frame met stempel 1.260.000. Een segment zonder map wordt gelezen alsof 0 op 0 valt.

Een verkeerde map verschuift elke ondertitel. Als de klok van de video bij 10 seconden begint en de map 0 zegt, toont een speler de ondertitels 10 seconden te laat, of helemaal niet. Schrijf de waarde die de encoder van de video gebruikte.

Ondertitels in een hele stream

De hoofdafspeellijst van een stream noemt de renditions: de video in meerdere groottes, de audio, en de ondertitels in elke taal, elk met een eigen afspeellijst.

#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",NAME="English",LANGUAGE="en",DEFAULT=YES,URI="en.m3u8"
Attribuut Wat erin staat
TYPE SUBTITLES
LANGUAGE De taal van de ondertitels, als BCP 47-tag
DEFAULT YES voor de ondertitels die worden getoond als de kijker niets heeft gekozen
URI De eigen afspeellijst van de ondertitels, zoals die hierboven

HLS of een WebVTT-bestand?

WebVTT-bestand HLS
Bestanden Eén Een afspeellijst en om de paar seconden een segment
Getoond door De <track> van een webpagina, spelers HLS-spelers: Safari, iPhone, Apple TV, en hls.js op het web
Aan de video gekoppeld door Tijden vanaf het begin De timestamp map, tegen de eigen tijdstempels van de video
Live — Segmenten toegevoegd terwijl het programma loopt

HLS in Subtitld

Bewaard in de segmenten
  • Elke tekst van een ondertitel en de regeleindes
  • Cursief, vet, onderstreept en kleur, zoals WebVTT ze bewaart
  • Waar hij staat, als cue-instellingen
  • Sprekers, als voice-tags
  • Begin en eind, tot de milliseconde
Geen plek
  • De taal: Subtitld schrijft de afspeellijst van de ondertitels, niet een hoofdafspeellijst die haar noemt
  • Vertalingen naast het origineel
  • Nasynchronisaties, gezichten en kleuren van sprekers

Sla een .usfx-project op om die te bewaren.

Een HLS-afspeellijst openen

Open het .m3u8-bestand. Subtitld:

  • volgt een hoofdafspeellijst naar de ondertitels: de rendition in de taal van het project, anders de standaard, anders de eerste;
  • leest elk segment dat de afspeellijst noemt, ernaast of op een http- of https-adres, en het deel van een bestand dat een byte range noemt;
  • leest de segmenten als WebVTT, en verschuift elk volgens zijn timestamp map, zodat het eerste moment van de stream 0 is;
  • bewaart een cue die herhaald wordt in de segmenten die hij beslaat één keer, en voegt een cue samen die een segmenter op de rand van een segment in tweeën knipte;
  • leest IMSC-segmenten in gefragmenteerde MP4, zoals CMAF ze draagt;
  • neemt de taal van de rendition als die van het project.

Een bestand dat niet met #EXTM3U begint, of een afspeellijst zonder ondertitels erin, zegt dat.

HLS exporteren

Het exportvenster van Subtitld met HLS gekozen, sprekers als voice-tags, segmenten van 6 seconden en de timestamp map op MPEGTS 900000

Bij Exporteren, dan Ondertitels en HLS, biedt u:

  • TekstHet origineel, een vertaling, of beide, de vertaling eronder.
  • SprekernamenWeggelaten, voor de tekst (Thom: …), of als voice-tags (<v Thom>).
  • OpmaakBewaard, of verwijderd.
  • Tijden verschuivenElke ondertitel eerder of later met dezelfde hoeveelheid.
  • Segmentlengte2, 4, 6 of 10 seconden. 6 is wat Apple aanbeveelt.
  • Timestamp mapMPEGTS:900000, 10 seconden, waar de meeste encoders de klok van een stream laten beginnen, of MPEGTS:0.

Subtitld schrijft de afspeellijst, versie 3, en een map ernaast die ernaar is genoemd (movie.m3u8, movie_segments) met de segmenten, segment00000.vtt enzovoort. Elk segment duurt even lang behalve het laatste, en heeft dezelfde map, zodat de cue-tijden die van het programma zijn. De segmenten lopen zo lang als de video, lege inbegrepen, of zo lang als de ondertitels als er geen video is. Opnieuw opslaan vervangt de segmenten in de map.

Voeg de afspeellijst toe aan de hoofdafspeellijst van uw stream met een regel #EXT-X-MEDIA:TYPE=SUBTITLES, de taal en het adres.

Wetenswaardigheden

2009

Apple bracht HTTP Live Streaming uit in mei 2009. Het werd in augustus 2017 gepubliceerd als RFC 8216, na jaren als Internet-Draft.

26,5 u

Hoe lang de klok van 90.000 ticks van MPEG-2-tijdstempels loopt voordat zijn 33 bits weer bij nul beginnen. RFC 8216 vraagt spelers daarmee om te gaan als het gebeurt en de cue-tijden doorlopen.

6 s

De authoringspecificatie van Apple zegt dat doelduren 6 seconden moeten zijn, en dat WebVTT-ondertitels een timestamp map moeten hebben.

Verwante formaten

Een .m3u8 om te repareren?

Open het in Subtitld met de video en stel de timing bij op de golfvorm.

Subtitld downloaden