WebVTT in HTTP Live Streaming

ВідкритиЗберегтиСтримінгВеб

Як HTTP Live Streaming від Apple передає субтитри: плейлист і файли WebVTT, які він перелічує, кожен на кілька секунд передачі. Плеєр завантажує їх під час відтворення, поруч із власними сегментами відео.

Коротко

Розширення.m3u8
Тип медіаПлейлист: application/vnd.apple.mpegurl. Його сегменти: text/vtt.
СпецифікаціяRFC 8216 (2017) і HLS Authoring Specification for Apple Devices від Apple. Сегменти — це WebVTT.
Точність часуМілісекунди, у субтитрах сегментів
Кодування текстуUTF-8, однаково для плейлиста й сегментів
ОформленняЯк у WebVTT: курсив, жирний, підкреслення й кольори через класи
РозміщенняНалаштування субтитрів WebVTT
МовціТеги голосу WebVTT: <v Thom>
У контейнерахДля WebVTT немає: прості текстові файли на вебсервері. Субтитри IMSC у HLS ідуть у фрагментованому MP4.

Будова плейлиста

Список сегментів, кожен зі своєю тривалістю. Субтитри — у файлах, які він називає.

#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 · Заголовок

    Спершу завжди #EXTM3U. Далі версія, номер першого сегмента і VOD: передача, всі сегменти якої вже є.

  2. 2 · Цільова тривалість

    Ціла кількість секунд, яку не перевищує округлена тривалість жодного сегмента.

  3. 3 · Тривалість

    Скільки триває наступний сегмент, у секундах.

  4. 4 · Адреса

    Де сегмент: тут поруч із плейлистом, або вебадреса.

  5. 5 · Кінець

    Більше нічого не буде. Пряма трансляція його пропускає і продовжує додавати сегменти.

Будова сегмента

Кожен сегмент — окремий файл WebVTT з ще одним рядком у заголовку.

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 · Заголовок

    WEBVTT, як у будь-якому файлі WebVTT.

  2. 2 · Карта часових міток

    Якому моменту відео відповідає час субтитра.

  3. 3 · Субтитри

    Кожен субтитр, що показується під час сегмента, кожен зі своїм повним часом, навіть із частиною поза сегментом.

Це другий сегмент, від 6 до 12 секунд. Його перший субтитр почався в першому сегменті, на 4-й секунді, і є в обох: плеєр, який починає звідси, все одно його покаже.

Карта часових міток

Кадри відео несуть часові мітки MPEG-2, що рахуються годинником на 90 000 тіків за секунду. Карта зв’язує два годинники:

Частина Що каже
LOCAL:00:00:00.000 Час субтитра в цьому файлі
MPEGTS:900000 Часова мітка відео в цей момент: 900 000 тіків, 10 секунд

Багато кодерів починають годинник потоку з 10 секунд, тож 900000 — звичайне значення. З картою субтитр на 00:00:04.000 показується разом із кадром із міткою 1 260 000. Сегмент без карти читається так, ніби 0 відповідає 0.

Помилкова карта зсуває кожен субтитр. Якщо годинник відео починається з 10 секунд, а карта каже 0, плеєр покаже субтитри на 10 секунд пізніше або взагалі не покаже. Записуйте значення, яке використав кодер відео.

Субтитри в цілому потоці

Головний плейлист потоку перелічує його варіанти: відео в кількох розмірах, аудіо й субтитри кожною мовою, кожен зі своїм плейлистом.

#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",NAME="English",LANGUAGE="en",DEFAULT=YES,URI="en.m3u8"
Атрибут Що містить
TYPE SUBTITLES
LANGUAGE Мова субтитрів, як тег BCP 47
DEFAULT YES для тих, що показуються, коли глядач нічого не вибрав
URI Власний плейлист субтитрів, як той, що вище

HLS чи файл WebVTT?

Файл WebVTT HLS
Файли Один Плейлист і сегмент кожні кілька секунд
Хто показує <track> вебсторінки, плеєри Плеєри HLS: Safari, iPhone, Apple TV, а у вебі hls.js
Прив’язка до відео Час від початку Карта часових міток, відносно власних міток відео
Пряма трансляція — Сегменти додаються в міру того, як іде передача

HLS у Subtitld

Зберігається в сегментах
  • Текст кожного субтитра та переноси рядків
  • Курсив, жирний, підкреслення та колір, як їх зберігає WebVTT
  • Де він стоїть, як налаштування субтитрів
  • Мовці, як теги голосу
  • Початок і кінець до мілісекунди
Нікуди подіти
  • Мова: Subtitld записує плейлист субтитрів, а не головний плейлист, який її називає
  • Переклади поруч з оригіналом
  • Дубляж, обличчя мовців і їхні кольори

Щоб зберегти це, збережіть проєкт .usfx.

Відкриття плейлиста HLS

Відкрийте файл .m3u8. Subtitld:

  • переходить від головного плейлиста до його субтитрів: варіанта мовою проєкту, інакше типового, інакше першого;
  • читає кожен сегмент, який перелічує плейлист, поруч із ним або за адресою http чи https, а також частину файлу, яку називає діапазон байтів;
  • читає сегменти як WebVTT і зсуває кожен за його картою часових міток, щоб перший момент потоку був 0;
  • залишає один раз субтитр, повторений у сегментах, які він охоплює, і з’єднує субтитр, розрізаний сегментатором надвоє на межі сегмента;
  • читає сегменти IMSC у фрагментованому MP4, як їх несе CMAF;
  • бере мову варіанта як мову проєкту.

Файл, що не починається з #EXTM3U, або плейлист без субтитрів так і повідомляє.

Експорт HLS

Діалог експорту Subtitld з вибраним HLS, мовцями як теги голосу, сегментами по 6 секунд і картою часових міток MPEGTS 900000

Експорт, далі Субтитри і HLS, пропонує:

  • ТекстОригінал, переклад або обидва, переклад унизу.
  • Імена мовцівНе вказувати, писати перед текстом (Thom: …) або як теги голосу (<v Thom>).
  • ОформленняЗберегти або прибрати.
  • Зсув часуКожен субтитр раніше або пізніше на однакову величину.
  • Тривалість сегмента2, 4, 6 або 10 секунд. Apple рекомендує 6.
  • Карта часових мітокMPEGTS:900000, 10 секунд, з яких більшість кодерів починає годинник потоку, або MPEGTS:0.

Subtitld записує плейлист версії 3 і теку поруч із ним, названу за ним (movie.m3u8, movie_segments), із сегментами segment00000.vtt і далі. Кожен сегмент, крім останнього, має однакову тривалість і однакову карту, тож час його субтитрів — це час передачі. Сегменти тривають стільки, скільки відео, включно з порожніми, або стільки, скільки субтитри, коли відео немає. Повторне збереження замінює сегменти в теці.

Додайте плейлист до головного плейлиста свого потоку рядком #EXT-X-MEDIA:TYPE=SUBTITLES з його мовою та адресою.

Цікаве

2009

Apple випустила HTTP Live Streaming у травні 2009 року. Його опубліковано як RFC 8216 у серпні 2017 року, після багатьох років у статусі Internet-Draft.

26,5 год

Стільки працює годинник часових міток MPEG-2 на 90 000 тіків, перш ніж його 33 біти обнуляться. RFC 8216 просить плеєри впоратися з цим, коли час субтитрів продовжується.

6 с

Специфікація авторингу Apple каже, що цільова тривалість має становити 6 секунд, а субтитри WebVTT мусять мати карту часових міток.

Пов'язані формати

Маєте .m3u8 для виправлення?

Відкрийте його в Subtitld разом із відео та вирівняйте за хвилею.

Завантажити Subtitld