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 · Заголовок
Спершу завжди
#EXTM3U. Далі версія, номер першого сегмента іVOD: передача, всі сегменти якої вже є. - 2 · Цільова тривалість
Ціла кількість секунд, яку не перевищує округлена тривалість жодного сегмента.
- 3 · Тривалість
Скільки триває наступний сегмент, у секундах.
- 4 · Адреса
Де сегмент: тут поруч із плейлистом, або вебадреса.
- 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 · Заголовок
WEBVTT, як у будь-якому файлі WebVTT. - 2 · Карта часових міток
Якому моменту відео відповідає час субтитра.
- 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
Експорт, далі Субтитри і 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 з його мовою та адресою.
Цікаве
Apple випустила HTTP Live Streaming у травні 2009 року. Його опубліковано як RFC 8216 у серпні 2017 року, після багатьох років у статусі Internet-Draft.
Стільки працює годинник часових міток MPEG-2 на 90 000 тіків, перш ніж його 33 біти обнуляться. RFC 8216 просить плеєри впоратися з цим, коли час субтитрів продовжується.
Специфікація авторингу Apple каже, що цільова тривалість має становити 6 секунд, а субтитри WebVTT мусять мати карту часових міток.
Пов'язані формати
Відкрийте його в Subtitld разом із відео та вирівняйте за хвилею.