WebVTT in HTTP Live Streaming
Il modo in cui l'HTTP Live Streaming di Apple porta i sottotitoli: una playlist, e i file WebVTT che elenca, ciascuno di pochi secondi del programma. Un lettore li scarica mentre riproduce, accanto ai segmenti del video stesso.
In breve
| Estensione | .m3u8 |
|---|---|
| Tipo di media | La playlist: application/vnd.apple.mpegurl. I suoi segmenti: text/vtt. |
| Specifica | RFC 8216 (2017), e la HLS Authoring Specification for Apple Devices di Apple. I segmenti sono WebVTT. |
| Precisione temporale | Millisecondi, nei cue dei segmenti |
| Codifica del testo | UTF-8, per la playlist come per i segmenti |
| Stile | Quello di WebVTT: corsivo, grassetto, sottolineato, e colori tramite classe |
| Posizionamento | Le impostazioni dei cue di WebVTT |
| Parlanti | I tag di voce di WebVTT: <v Thom> |
| Nei contenitori | Nessuno per WebVTT: file di testo semplice su un server web. I sottotitoli IMSC in HLS arrivano in MP4 frammentato. |
Anatomia di una playlist
Un elenco di segmenti, ciascuno con la sua durata. I sottotitoli sono nei file che nomina.
#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 · Intestazione
#EXTM3Uper primo, sempre. Poi la versione, il numero del primo segmento, eVOD: un programma i cui segmenti ci sono già tutti. - 2 · Durata obiettivo
Secondi interi che la durata di nessun segmento, arrotondata, supera.
- 3 · Durata
Quanto dura il segmento che segue, in secondi.
- 4 · Indirizzo
Dove si trova il segmento: qui accanto alla playlist, o un indirizzo web.
- 5 · Fine
Non arriverà nient'altro. Una diretta lo omette e continua ad aggiungere segmenti.
Anatomia di un segmento
Ogni segmento è un file WebVTT a sé, con una riga in più nell'intestazione.
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 · Intestazione
WEBVTT, come in qualsiasi file WebVTT. - 2 · Mappa dei timestamp
Quale momento del video rappresenta un tempo di cue.
- 3 · Cue
Ogni cue mostrato durante il segmento, ciascuno con il suo tempo intero, anche la parte fuori dal segmento.
Questo è il secondo segmento, da 6 a 12 secondi. Il suo primo cue è iniziato nel primo segmento, a 4 secondi, e si trova in entrambi: un lettore che parte da qui lo mostra comunque.
La mappa dei timestamp
I fotogrammi del video portano timestamp MPEG-2, contati su un orologio di 90.000 tick al secondo. La mappa lega tra loro i due orologi:
| Parte | Cosa dice |
|---|---|
LOCAL:00:00:00.000 |
Un tempo di cue in questo file |
MPEGTS:900000 |
Il timestamp del video in quel momento: 900.000 tick, 10 secondi |
Molti encoder fanno partire l'orologio di un flusso da 10 secondi, quindi 900000 è il valore abituale. Con la mappa, un cue a 00:00:04.000 viene mostrato con il fotogramma marcato 1.260.000. Un segmento senza mappa viene letto come se mappasse 0 su 0.
Una mappa sbagliata sposta ogni sottotitolo. Se l'orologio del video parte da 10 secondi e la mappa dice 0, un lettore mostra i sottotitoli con 10 secondi di ritardo, o non li mostra affatto. Scriva il valore usato dall'encoder del video.
I sottotitoli in un flusso completo
La playlist principale di un flusso elenca le sue rendition: il video in diverse dimensioni, l'audio, e i sottotitoli in ogni lingua, ciascuno con una propria playlist.
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",NAME="English",LANGUAGE="en",DEFAULT=YES,URI="en.m3u8"
| Attributo | Cosa contiene |
|---|---|
TYPE |
SUBTITLES |
LANGUAGE |
La lingua dei sottotitoli, come tag BCP 47 |
DEFAULT |
YES per quella mostrata quando lo spettatore non ne ha scelta nessuna |
URI |
La playlist propria dei sottotitoli, come quella qui sopra |
HLS o un file WebVTT?
| File WebVTT | HLS | |
|---|---|---|
| File | Uno | Una playlist e un segmento ogni pochi secondi |
| Mostrato da | Il <track> di una pagina web, i lettori |
I lettori HLS: Safari, iPhone, Apple TV, e hls.js sul web |
| Legato al video da | I tempi dall'inizio | La mappa dei timestamp, rispetto ai timestamp del video stesso |
| Diretta | — | Segmenti aggiunti man mano che il programma procede |
HLS in Subtitld
- Testo e a capo di ogni sottotitolo
- Corsivo, grassetto, sottolineato e colore, come li conserva WebVTT
- Dove si trova, come impostazioni del cue
- I parlanti, come tag di voce
- Inizio e fine, al millisecondo
- La lingua: Subtitld scrive la playlist dei sottotitoli, non una playlist principale che la nomini
- Traduzioni accanto all'originale
- Doppiaggi, volti e colori dei parlanti
Salvi un progetto .usfx per conservarli.
Aprire una playlist HLS
Apra il file .m3u8. Subtitld:
- segue una playlist principale fino ai suoi sottotitoli: la rendition nella lingua del progetto, altrimenti quella predefinita, altrimenti la prima;
- legge ogni segmento che la playlist elenca, accanto a essa o a un indirizzo
httpohttps, e la parte di un file indicata da un byte range; - legge i segmenti come WebVTT, e sposta ciascuno secondo la sua mappa dei timestamp, così che il primo momento del flusso sia 0;
- conserva una sola volta un cue ripetuto nei segmenti che attraversa, e riunisce un cue che un segmentatore ha tagliato in due al bordo di un segmento;
- legge i segmenti IMSC in MP4 frammentato, come li porta CMAF;
- prende la lingua della rendition come quella del progetto.
Un file che non inizia con #EXTM3U, o una playlist senza sottotitoli, lo dice.
Esportare HLS
Con Esporta, poi Sottotitoli e HLS, si offrono:
- TestoL'originale, una traduzione, o entrambi, con la traduzione sotto.
- Nomi dei parlantiOmessi, prima del testo (Thom: …), oppure come tag di voce (
<v Thom>). - FormattazioneConservata, oppure rimossa.
- Sposta i tempiOgni sottotitolo anticipato o ritardato della stessa quantità.
- Durata dei segmenti2, 4, 6 o 10 secondi. 6 è ciò che raccomanda Apple.
- Mappa dei timestamp
MPEGTS:900000, 10 secondi, da dove la maggior parte degli encoder fa partire l'orologio di un flusso, oppureMPEGTS:0.
Subtitld scrive la playlist, versione 3, e accanto una cartella con il suo nome (movie.m3u8, movie_segments) con i segmenti, segment00000.vtt e seguenti. Tutti i segmenti durano uguale tranne l'ultimo, e hanno la stessa mappa, quindi i tempi dei loro cue sono quelli del programma. I segmenti coprono tutta la durata del video, compresi quelli vuoti, o quella dei sottotitoli quando non c'è un video. Salvando di nuovo si sostituiscono i segmenti nella cartella.
Aggiunga la playlist alla playlist principale del suo flusso con una riga #EXT-X-MEDIA:TYPE=SUBTITLES, la sua lingua e il suo indirizzo.
Curiosità
Apple pubblicò l'HTTP Live Streaming nel maggio 2009. Divenne l'RFC 8216 nell'agosto 2017, dopo anni come Internet-Draft.
Quanto gira l'orologio a 90.000 tick dei timestamp MPEG-2 prima che i suoi 33 bit tornino a zero. L'RFC 8216 chiede ai lettori di gestire il momento in cui succede mentre i tempi dei cue proseguono.
La specifica di authoring di Apple dice che le durate obiettivo dovrebbero essere di 6 secondi, e che i sottotitoli WebVTT devono avere una mappa dei timestamp.
Formati correlati
Lo apra in Subtitld con il video e lo sincronizzi sulla forma d'onda.