Конвертер JSON в TTML
Или вставьте текст субтитров
Что меняет эта конвертация
1 пункт теряется или требует решения
- Караоке
тайминг караоке (подсветка по слогам)
Этот список выведен из матрицы возможностей этих двух форматов, а не из загруженного файла. Конкретный файл может потерять больше, если использует возможности, которые формат допускает, а матрица не моделирует.
Здесь субтитры JSON превращаются в TTML: JSON — это внутренний формат сайта, который хранит полную модель субтитров, а TTML — XML-формат для вещания и стриминга, где время и оформление заданы атрибутами. JSON записывает интервал ("start": 1000, "end": 3500), а TTML хранит его в атрибутах begin="00:00:01.000" и end="00:00:03.500". Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
Сайт перечисляет потери до запуска — караоке; JSON хранит послоговую подсветку, а TTML не поддерживает караоке: останется цельный текст без тайминга слогов.
Ни один байт субтитров не уходит в сеть: конвертация выполняется в текущей вкладке, а готовые файлы забираются архивом.
Примеры
Обычный файл JSON, переведённый в TTML
Вход
{
"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"
}
]
}
Выход
<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling">
<body>
<p begin="00:00:00.000" end="00:00:02.000">Hello world.<br/>Second line.</p>
<p begin="00:00:02.500" end="00:00:04.000">Plain line.<br/><span tts:fontStyle="italic">Styled</span> line.</p>
<p begin="00:00:04.500" end="00:00:06.000">Roger: I am here.</p> </body>
</tt>
Сравните две стороны: JSON записывает время как "start": 1000, TTML — как begin="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" }
]
Выход
<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling">
<body>
<p begin="00:00:00.000" end="00:00:01.000">First.</p>
<p begin="00:00:01.000" end="00:00:02.000">Second.</p>
<p begin="00:00:02.000" end="00:00:03.000">Third.</p> </body>
</tt>
Второй файл намеренно неровный: переводы строк CRLF. JSON читает его без падения, а TTML записывается заново, поэтому часть дефектов исчезает, но пропущенные блоки не возвращаются.
Частые вопросы
Какие таймкоды получатся на выходе при переводе JSON в TTML?
JSON записывает интервал ("start": 1000, "end": 3500), а TTML хранит его в атрибутах begin="00:00:01.000" и end="00:00:03.500". Обе шкалы миллисекундные, поэтому значения времени переносятся без округления.
Какие данные JSON не переживут перевод в TTML?
JSON хранит послоговую подсветку, а TTML не поддерживает караоке: останется цельный текст без тайминга слогов. Это полный список потерь для пары JSON → TTML; сайт показывает его до запуска.
Как реплики JSON выглядят внутри TTML?
TTML — это XML: каждая реплика становится элементом p с атрибутами begin="00:00:01.000" и end="00:00:03.500". Оформление JSON переносится в атрибуты tts и элементы span, а перенос строки — в br.
Что произойдёт с многострочными репликами JSON в файле TTML?
Оба формата хранят жёсткий перенос внутри реплики, поэтому две строки JSON останутся двумя строками в TTML; порядок реплик не меняется.
В какой кодировке сохраняется TTML и какое у него расширение при переводе из JSON?
Файл TTML записывается в UTF-8 без BOM с переводами строк LF и расширением .ttml; при чтении JSON сайт сам определяет BOM и стиль переводов строк и нормализует их. Кириллица и другие алфавиты сохраняются без замены символов.
Почему из JSON в TTML теряется меньше, чем из других форматов?
JSON хранит полную внутреннюю модель: время в миллисекундах, строки, теги, стили, позиции и караоке. TTML принимает только часть этих полей, поэтому потери определяются возможностями TTML, а не исходником; остальное сайт перечисляет до запуска.