WebVTT in HTTP Live Streaming

AperturaSalvataggioStreamingWeb

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 mediaLa playlist: application/vnd.apple.mpegurl. I suoi segmenti: text/vtt.
SpecificaRFC 8216 (2017), e la HLS Authoring Specification for Apple Devices di Apple. I segmenti sono WebVTT.
Precisione temporaleMillisecondi, nei cue dei segmenti
Codifica del testoUTF-8, per la playlist come per i segmenti
StileQuello di WebVTT: corsivo, grassetto, sottolineato, e colori tramite classe
PosizionamentoLe impostazioni dei cue di WebVTT
ParlantiI tag di voce di WebVTT: <v Thom>
Nei contenitoriNessuno 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. 1 · Intestazione

    #EXTM3U per primo, sempre. Poi la versione, il numero del primo segmento, e VOD: un programma i cui segmenti ci sono già tutti.

  2. 2 · Durata obiettivo

    Secondi interi che la durata di nessun segmento, arrotondata, supera.

  3. 3 · Durata

    Quanto dura il segmento che segue, in secondi.

  4. 4 · Indirizzo

    Dove si trova il segmento: qui accanto alla playlist, o un indirizzo web.

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

    WEBVTT, come in qualsiasi file WebVTT.

  2. 2 · Mappa dei timestamp

    Quale momento del video rappresenta un tempo di cue.

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

Conservato nei segmenti
  • 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
Nessun posto dove andare
  • 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 http o https, 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

La finestra di esportazione di Subtitld con HLS scelto, i parlanti come tag di voce, segmenti di 6 secondi e la mappa dei timestamp a MPEGTS 900000

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 timestampMPEGTS:900000, 10 secondi, da dove la maggior parte degli encoder fa partire l'orologio di un flusso, oppure MPEGTS: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à

2009

Apple pubblicò l'HTTP Live Streaming nel maggio 2009. Divenne l'RFC 8216 nell'agosto 2017, dopo anni come Internet-Draft.

26,5 h

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.

6 s

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

Ha un file .m3u8 da correggere?

Lo apra in Subtitld con il video e lo sincronizzi sulla forma d'onda.

Scarica Subtitld