TTML 转 JSON
或者粘贴字幕文本
这次转换会改变什么
有 1 项会被丢弃或需要你决定
- 格式专有内容
源格式保留在字幕条之外的内容（非字幕块、文件头文字、单条字幕的设置、被注释掉的事件）——目标格式没有地方存放它们
这份清单来自这两种格式的能力矩阵，而不是你加载的这份具体文件。如果具体文件用到了格式允许、但矩阵没有建模的特性，可能会丢得更多。
这一页把 TTML 写成 JSON：顶层是 `version` 与 `cues`，每条 cue 有 `start`、`end`（整数毫秒）与 `lines`；`<br/>` 拆成两条行记录，仍然属于同一条 cue。
TTML 与 JSON 之间真正“结构化”的一层是段落内的强调：`<span tts:fontStyle="italic">there</span>` 会落成该行的 `tags` 数组，带 `kind`、`start`、`end`，颜色还会带 `value`（例如 `#FF0000`）。文字本身不变，标签是相对文字区间的标注。
丢的是头部：XML 声明与命名空间、`<styling>` 表、`<layout>` 表、`<metadata>`，以及 `<p>` 上的 `style` / `region` 引用。JSON 输出里有 `styles` 对象，但没有任何头部定义被翻译进去，所以它是空的；头部信息不会伪装成结构化字段。
时间不丢：TTML 写 `00:00:04.126`，JSON 写 `4126`，不四舍五入。产物按开始时间升序，UTF-8、LF、无 BOM；批量串行、可取消、ZIP 打包，不上传。
示例
一份典型的 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 头部（样式表、区域表、命名空间）；段落内的强调以结构化标签保留。
同一转换遇到一份脏输入
输入
<?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"
}
]
}
]
}
]
}
这一份用了真实的写法混排：偏移加时长、粗一点的时钟拼法、按帧号写的时间、实体与只有开始时间的半开 cue。可以看解析器把哪些写法折成了同一份时间轴。
常见问题
TTML 转 JSON 后，`<span>` 的斜体和颜色怎么表示？
写成该行的 `tags` 数组：斜体是 `{"kind":"italic","start":6,"end":11}`，颜色是 `{"kind":"color",…,"value":"#FF0000"}`。区间是相对文字本身的偏移。
TTML 转 JSON 的 `styles` 对象为什么是空的？
因为头部的 `<styling>` 表没有被翻译进去。JSON 有 `styles` 这个字段，但 TTML 的具名样式属于格式私有构造，这一页不把它们改写成 JSON 的样式对象。
TTML 转 JSON 时毫秒会四舍五入吗？
不会。TTML 的 `00:00:04.126` 写成整数 `4126`，两边都是毫秒；只有偏移与帧号写法需要先折算成毫秒。
TTML 转 JSON 后，一条两行字幕怎么表示？
`lines` 数组里两条记录，顺序不变。它仍然是一条 cue，时间字段只有一对 `start` / `end`。
TTML 的 `region` 在 JSON 里有字段吗？
没有。`region` 是对 `<layout>` 表的引用，属于头部；JSON 的 cue 只保留时间、文字与行内标签，不保留屏幕位置。
JSON 再转回 TTML 会丢掉什么？
丢掉卡拉OK计时。JSON 能带行内标签，但 TTML 的 cue 模型没有逐字计时这一维；其余时间与文字可以对上。