WebVTT in HTTP Live Streaming

AbrirGuardarStreamingWeb

Cómo lleva los subtítulos el HTTP Live Streaming de Apple: una lista de reproducción, y los archivos WebVTT que enumera, cada uno con unos pocos segundos del programa. Un reproductor los descarga mientras reproduce, junto a los segmentos del propio vídeo.

De un vistazo

Extensión.m3u8
Tipo de medioLa lista de reproducción: application/vnd.apple.mpegurl. Sus segmentos: text/vtt.
EspecificaciónRFC 8216 (2017), y la HLS Authoring Specification for Apple Devices de Apple. Los segmentos son WebVTT.
Precisión temporalMilisegundos, en los cues de los segmentos
Codificación del textoUTF-8, tanto para la lista de reproducción como para los segmentos
EstiloEl de WebVTT: cursiva, negrita, subrayado, y colores por clase
PosiciónLos ajustes de cue de WebVTT
HablantesLas etiquetas de voz de WebVTT: <v Thom>
En contenedoresNinguno para WebVTT: archivos de texto plano en un servidor web. Los subtítulos IMSC en HLS van en MP4 fragmentado.

Anatomía de una lista de reproducción

Una lista de segmentos, cada uno con su duración. Los subtítulos están en los archivos que nombra.

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

    #EXTM3U primero, siempre. Luego la versión, el número del primer segmento, y VOD: un programa con todos sus segmentos disponibles.

  2. 2 · Duración objetivo

    Segundos enteros que la duración de ningún segmento, redondeada, supera.

  3. 3 · Duración

    Cuánto dura el segmento que le sigue, en segundos.

  4. 4 · Dirección

    Dónde está el segmento: aquí, junto a la lista de reproducción, o en una dirección web.

  5. 5 · Fin

    No vendrá nada más. Una emisión en directo lo omite y sigue añadiendo segmentos.

Anatomía de un segmento

Cada segmento es un archivo WebVTT propio, con una línea más en su cabecera.

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

    WEBVTT, como en cualquier archivo WebVTT.

  2. 2 · Mapa de marcas de tiempo

    A qué momento del vídeo corresponde un tiempo de cue.

  3. 3 · Cues

    Cada cue que se muestra durante el segmento, cada uno con su tiempo completo, incluso la parte que queda fuera del segmento.

Este es el segundo segmento, de 6 a 12 segundos. Su primer cue empezó en el primer segmento, a los 4 segundos, y está en ambos: un reproductor que empieza aquí lo sigue mostrando.

El mapa de marcas de tiempo

Los fotogramas del vídeo llevan marcas de tiempo MPEG-2, contadas en un reloj de 90 000 ticks por segundo. El mapa une los dos relojes:

Parte Qué dice
LOCAL:00:00:00.000 Un tiempo de cue en este archivo
MPEGTS:900000 La marca de tiempo del vídeo en ese momento: 900 000 ticks, 10 segundos

Muchos codificadores empiezan el reloj de un flujo en 10 segundos, así que 900000 es el valor habitual. Con el mapa, un cue en 00:00:04.000 se muestra con el fotograma marcado 1 260 000. Un segmento sin mapa se lee como si asociara 0 con 0.

Un mapa erróneo mueve todos los subtítulos. Si el reloj del vídeo empieza en 10 segundos y el mapa dice 0, un reproductor muestra los subtítulos 10 segundos tarde, o no los muestra. Escribe el valor que usó el codificador del vídeo.

Subtítulos en un flujo completo

La lista de reproducción principal de un flujo enumera sus variantes: el vídeo en varios tamaños, el audio, y los subtítulos en cada idioma, cada uno con su propia lista de reproducción.

#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",NAME="English",LANGUAGE="en",DEFAULT=YES,URI="en.m3u8"
Atributo Qué guarda
TYPE SUBTITLES
LANGUAGE El idioma de los subtítulos, como etiqueta BCP 47
DEFAULT YES para la que se muestra cuando el espectador no ha elegido ninguna
URI La propia lista de reproducción de los subtítulos, como la de arriba

¿HLS o un archivo WebVTT?

Archivo WebVTT HLS
Archivos Uno Una lista de reproducción y un segmento cada pocos segundos
Lo muestran El <track> de una página web, los reproductores Los reproductores HLS: Safari, iPhone, Apple TV, y hls.js en la web
Se une al vídeo por Los tiempos desde el inicio El mapa de marcas de tiempo, frente a las marcas de tiempo del propio vídeo
En directo — Segmentos que se añaden a medida que avanza el programa

HLS en Subtitld

Se conserva en los segmentos
  • El texto de cada subtítulo y sus saltos de línea
  • Cursiva, negrita, subrayado y color, como los conserva WebVTT
  • Dónde se sitúa, como ajustes de cue
  • Los hablantes, como etiquetas de voz
  • Inicio y fin, al milisegundo
Sin dónde ir
  • El idioma: Subtitld escribe la lista de reproducción de los subtítulos, no una lista principal que la nombre
  • Traducciones junto al original
  • Doblajes, caras y colores de los hablantes

Guarda un proyecto .usfx para conservarlos.

Abrir una lista de reproducción HLS

Abre el archivo .m3u8. Subtitld:

  • sigue una lista principal hasta sus subtítulos: la variante en el idioma del proyecto, o si no, la predeterminada, o si no, la primera;
  • lee cada segmento que enumera la lista, a su lado o en una dirección http o https, y la parte de un archivo que indica un rango de bytes;
  • lee los segmentos como WebVTT, y desplaza cada uno según su mapa de marcas de tiempo, para que el primer momento del flujo sea 0;
  • conserva una sola vez un cue repetido en los segmentos que abarca, y une un cue que un segmentador cortó en dos en el borde de un segmento;
  • lee segmentos IMSC en MP4 fragmentado, como los lleva CMAF;
  • toma el idioma de la variante como el del proyecto.

Un archivo que no empieza por #EXTM3U, o una lista de reproducción sin subtítulos, lo dice.

Exportar HLS

Diálogo de exportación de Subtitld con HLS elegido, hablantes como etiquetas de voz, segmentos de 6 segundos y el mapa de marcas de tiempo en MPEGTS 900000

Exportar, y luego Subtítulos y HLS, ofrece:

  • TextoEl original, una traducción o ambos, con la traducción debajo.
  • Nombres de hablantesSe omiten, van antes del texto (Thom: …), o como etiquetas de voz (<v Thom>).
  • FormatoSe conserva o se quita.
  • Desplazar tiemposCada subtítulo antes o después en la misma cantidad.
  • Duración de los segmentos2, 4, 6 o 10 segundos. 6 es lo que recomienda Apple.
  • Mapa de marcas de tiempoMPEGTS:900000, 10 segundos, donde la mayoría de codificadores empiezan el reloj de un flujo, o MPEGTS:0.

Subtitld escribe la lista de reproducción, versión 3, y una carpeta a su lado con su nombre (movie.m3u8, movie_segments) con los segmentos, segment00000.vtt y siguientes. Todos los segmentos duran lo mismo salvo el último, y tienen el mismo mapa, así que sus tiempos de cue son los del programa. Los segmentos abarcan toda la duración del vídeo, incluidos los vacíos, o la de los subtítulos cuando no hay vídeo. Guardar de nuevo sustituye los segmentos de la carpeta.

Añade la lista de reproducción a la lista principal de tu flujo con una línea #EXT-X-MEDIA:TYPE=SUBTITLES, su idioma y su dirección.

Curiosidades

2009

Apple lanzó HTTP Live Streaming en mayo de 2009. Se publicó como RFC 8216 en agosto de 2017, tras años como Internet-Draft.

26,5 h

Lo que tarda el reloj de 90 000 ticks de las marcas de tiempo MPEG-2 en volver a cero al desbordar sus 33 bits. RFC 8216 pide a los reproductores que lo soporten cuando ocurre y los tiempos de cue siguen avanzando.

6 s

La especificación de autoría de Apple dice que las duraciones objetivo deberían ser de 6 segundos, y que los subtítulos WebVTT deben tener un mapa de marcas de tiempo.

Formatos relacionados

¿Tienes un .m3u8 que corregir?

Ábrelo en Subtitld con el vídeo y reajústalo sobre la forma de onda.

Descargar Subtitld