Конвертер JSON в VTT
Или вставьте текст субтитров
Что меняет эта конвертация
3 пункта теряются или требуют решения
- Оформление
всё оформление, кроме жирного и курсива (цвет, обводка, тень, отступы)
- Позиционирование
положение на экране (каждая реплика возвращается в стандартное положение)
- Караоке
тайминг караоке (подсветка по слогам)
Этот список выведен из матрицы возможностей этих двух форматов, а не из загруженного файла. Конкретный файл может потерять больше, если использует возможности, которые формат допускает, а матрица не моделирует.
Перевод JSON в VTT меняет не содержание, а способ записи: JSON — внутренний формат сайта, который хранит полную модель субтитров, VTT — веб-формат субтитров с обязательной строкой WEBVTT в начале файла. Начало, которое JSON записывает как "start": 1000, в VTT выглядит как 00:00:01.000: значения времени сохраняются, меняется только синтаксис. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
Сайт перечисляет потери до запуска — оформление, позиционирование, караоке; JSON поддерживает полное оформление, а VTT сохранит только жирный и курсив: цвет, обводка, поля и шрифт исчезнут.
Обработка идёт на вашем устройстве, без регистрации и без передачи файлов: пакет из нескольких серий обрабатывается по очереди.
Примеры
Обычный файл JSON, переведённый в VTT
Вход
{
"version": 1,
"title": "Fixture: typical",
"fps": 25,
"styles": {
"Default": {
"name": "Default",
"fontFamily": "Arial",
"fontSize": 20,
"primaryColor": "#FFFFFF",
"bold": false,
"italic": false
}
},
"generator": "subtitlematrix fixtures",
"cues": [
{
"id": "1",
"start": 0,
"end": 2000,
"lines": [
"Hello world.",
"Second line."
],
"style": "Default",
"position": {
"x": 100,
"y": 200,
"align": "center"
}
},
{
"id": "2",
"start": 2500,
"end": 4000,
"lines": [
"Plain line.",
{
"text": "Styled line.",
"tags": [
{
"kind": "italic",
"start": 0,
"end": 6
}
]
}
]
},
{
"id": "3",
"start": 4500,
"end": 6000,
"lines": [
"Roger: I am here."
],
"speaker": "Roger"
}
]
}
Выход
WEBVTT
1
00:00:00.000 --> 00:00:02.000
Hello world.
Second line.
2
00:00:02.500 --> 00:00:04.000
Plain line.
<i>Styled</i> line.
3
00:00:04.500 --> 00:00:06.000
Roger: I am here.
Сравните две стороны: JSON записывает время как "start": 1000, VTT — как 00:00:01.000; текст и порядок реплик при этом сохраняются.
Тот же перевод на неаккуратном файле JSON
Вход
[
{ "start": 0, "end": 1000, "lines": ["First."] },
{ "start": 1000, "end": 2000, "text": "Second." },
"not an object",
{ "start": 2000, "end": 3000, "lines": ["Third."], "class": "top" }
]
Выход
WEBVTT
00:00:00.000 --> 00:00:01.000
First.
00:00:01.000 --> 00:00:02.000
Second.
00:00:02.000 --> 00:00:03.000
Third.
Второй файл намеренно неровный: переводы строк CRLF. JSON читает его без падения, а VTT записывается заново, поэтому часть дефектов исчезает, но пропущенные блоки не возвращаются.
Частые вопросы
Сохранится ли точность таймкода JSON в файле VTT?
Начало, которое JSON записывает как "start": 1000, в VTT выглядит как 00:00:01.000: значения времени сохраняются, меняется только синтаксис. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
Что именно теряется при конвертации JSON в VTT?
JSON поддерживает полное оформление, а VTT сохранит только жирный и курсив: цвет, обводка, поля и шрифт исчезнут. JSON расставляет реплики по экрану, а VTT не хранит координат: все реплики вернутся в позицию по умолчанию. JSON хранит послоговую подсветку, а VTT не поддерживает караоке: останется цельный текст без тайминга слогов. Это полный список потерь для пары JSON → VTT; сайт показывает его до запуска.
Почему из JSON в VTT теряется меньше, чем из других форматов?
JSON хранит полную внутреннюю модель: время в миллисекундах, строки, теги, стили, позиции и караоке. VTT принимает только часть этих полей, поэтому потери определяются возможностями VTT, а не исходником; остальное сайт перечисляет до запуска.
Сохранятся ли переносы строк и порядок реплик при переводе JSON в VTT?
Оба формата хранят жёсткий перенос внутри реплики, поэтому две строки JSON останутся двумя строками в VTT; порядок реплик не меняется.
В какой кодировке сохраняется VTT и какое у него расширение при переводе из JSON?
Файл VTT записывается в UTF-8 без BOM с переводами строк LF и расширением .vtt; при чтении JSON сайт сам определяет BOM и стиль переводов строк и нормализует их. Кириллица и другие алфавиты сохраняются без замены символов.
Зачем в начале файла VTT появляется строка WEBVTT при переводе JSON в VTT?
Это обязательный заголовок VTT: без него плеер не считает файл субтитрами. В JSON такого заголовка нет, поэтому сайт добавляет его и переписывает таймкоды с запятой на точку, сохраняя начало и конец до миллисекунды.