WebVTT in HTTP Live Streaming
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 |
|---|---|
| Mediatype | De afspeellijst: application/vnd.apple.mpegurl. De segmenten: text/vtt. |
| Specificatie | RFC 8216 (2017), en de HLS Authoring Specification for Apple Devices van Apple. De segmenten zijn WebVTT. |
| Tijdsprecisie | Milliseconden, in de cues van de segmenten |
| Tekstcodering | UTF-8, voor de afspeellijst en de segmenten gelijk |
| Opmaak | Die van WebVTT: cursief, vet, onderstreping, en kleuren via klassen |
| Positionering | De cue-instellingen van WebVTT |
| Sprekers | De voice-tags van WebVTT: <v Thom> |
| In containers | Geen 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 · Kop
#EXTM3Ueerst, altijd. Dan de versie, het nummer van het eerste segment, enVOD: een programma waarvan alle segmenten er zijn. - 2 · Doelduur
Hele seconden waar de afgeronde duur van geen enkel segment overheen gaat.
- 3 · Duur
Hoe lang het segment erna duurt, in seconden.
- 4 · Adres
Waar het segment staat: hier naast de afspeellijst, of een webadres.
- 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 · Kop
WEBVTT, zoals in elk WebVTT-bestand. - 2 · Timestamp map
Voor welk moment van de video een cue-tijd staat.
- 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
- 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
- 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- ofhttps-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
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 map
MPEGTS:900000, 10 seconden, waar de meeste encoders de klok van een stream laten beginnen, ofMPEGTS: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
Apple bracht HTTP Live Streaming uit in mei 2009. Het werd in augustus 2017 gepubliceerd als RFC 8216, na jaren als Internet-Draft.
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.
De authoringspecificatie van Apple zegt dat doelduren 6 seconden moeten zijn, en dat WebVTT-ondertitels een timestamp map moeten hebben.
Verwante formaten
Open het in Subtitld met de video en stel de timing bij op de golfvorm.