Конвертер TTML в JSON
Или вставьте текст субтитров
Что меняет эта конвертация
1 пункт теряется или требует решения
- Содержимое формата
содержимое, которое исходный формат хранит вне реплик (блоки не-реплик, текст заголовка, настройки реплик, закомментированные события): целевому формату его некуда деть
Этот список выведен из матрицы возможностей этих двух форматов, а не из загруженного файла. Конкретный файл может потерять больше, если использует возможности, которые формат допускает, а матрица не моделирует.
Здесь субтитры TTML превращаются в JSON: TTML — это XML-формат для вещания и стриминга, где время и оформление заданы атрибутами, а JSON — внутренний формат сайта, который хранит полную модель субтитров. TTML записывает интервал (begin="00:00:01.000" end="00:00:03.500"), а JSON хранит его целыми миллисекундами: start 1000, end 3500. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
Сайт перечисляет потери до запуска — раздел head TTML; TTML хранит пролог и раздел head со стилями, регионами и метаданными, а JSON их не переносит.
Ни один байт субтитров не уходит в сеть: конвертация выполняется в текущей вкладке, а готовые файлы забираются архивом.
Примеры
Обычный файл TTML, переведённый в JSON
Вход
<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling" xml:lang="en">
<head>
<styling>
<style xml:id="s1" tts:color="#FFFF00" tts:fontWeight="bold"/>
</styling>
<layout>
<region xml:id="bottom" tts:origin="10% 80%" tts:extent="80% 20%"/>
</layout>
</head>
<body>
<div>
<p begin="00:00:01.000" end="00:00:03.500" region="bottom" style="s1">Hello <span tts:fontStyle="italic">there</span>.</p>
<p begin="00:00:03.500" end="00:00:06.000" region="bottom">How are you?<br/>Fine, thanks.</p>
</div>
</body>
</tt>
Выход
{
"version": 1,
"cues": [
{
"start": 1000,
"end": 3500,
"lines": [
{
"text": "Hello there.",
"tags": [
{
"kind": "italic",
"start": 6,
"end": 11
}
]
}
]
},
{
"start": 3500,
"end": 6000,
"lines": [
"How are you?",
"Fine, thanks."
]
}
]
}
Сравните две стороны: TTML записывает время как begin="00:00:01.000", JSON — как "start": 1000; текст и порядок реплик при этом сохраняются.
Тот же перевод на неаккуратном файле TTML
Вход
<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling"
xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
ttp:frameRate="25" xml:lang="en">
<body>
<div>
<p begin="1.5s" dur="2s">Loaded from an offset and a duration.</p>
<p begin="4s" end="00:00:06.50">A coarser clock spelling.</p>
<p begin="00:00:07:00" end="00:00:08:12">Frames, at 25fps.</p>
<p begin="9s"><span tts:color="#FF0000">Half-open</span> and Tom & Jerry.</p>
</div>
</body>
</tt>
Выход
{
"version": 1,
"cues": [
{
"start": 1500,
"end": 3500,
"lines": [
"Loaded from an offset and a duration."
]
},
{
"start": 4000,
"end": 6500,
"lines": [
"A coarser clock spelling."
]
},
{
"start": 7000,
"end": 8480,
"lines": [
"Frames, at 25fps."
]
},
{
"start": 9000,
"end": 11000,
"lines": [
{
"text": "Half-open and Tom & Jerry.",
"tags": [
{
"kind": "color",
"start": 0,
"end": 9,
"value": "#FF0000"
}
]
}
]
}
]
}
Второй файл проверяет граничные случаи. TTML читает его без падения, а JSON записывается заново, поэтому часть дефектов исчезает, но пропущенные блоки не возвращаются.
Частые вопросы
Какие таймкоды получатся на выходе при переводе TTML в JSON?
TTML записывает интервал (begin="00:00:01.000" end="00:00:03.500"), а JSON хранит его целыми миллисекундами: start 1000, end 3500. Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
Какие данные TTML не переживут перевод в JSON?
TTML хранит пролог и раздел head со стилями, регионами и метаданными, а JSON их не переносит. Это полный список потерь для пары TTML → JSON; сайт показывает его до запуска.
Что сайт читает из head и стилей TTML перед переводом в JSON?
TTML хранит время в begin и end, текст в p, а оформление — в tts-атрибутах, стилях и регионах раздела head. В JSON переносится то, что он умеет: текст и интервалы; стили и регионы теряются, если целевой формат их не поддерживает.
Не перепутается ли порядок реплик после конвертации TTML в JSON?
Оба формата хранят жёсткий перенос внутри реплики, поэтому две строки TTML останутся двумя строками в JSON; порядок реплик не меняется.
В какой кодировке сохраняется JSON и какое у него расширение при переводе из TTML?
Файл JSON записывается в UTF-8 без BOM с переводами строк LF и расширением .json; при чтении TTML сайт сам определяет BOM и стиль переводов строк и нормализует их. Кириллица и другие алфавиты сохраняются без замены символов.
Сохранятся ли регионы и стили из head TTML при переводе TTML в JSON?
TTML описывает оформление в разделе head — в стилях, регионах и метаданных. JSON поддерживает и стили, и позиционирование, поэтому основная часть оформления переносится.