跳到主要内容
SubtitleMatrix

TTML 转 VTT

格式转换TTML / DFXP
或者粘贴字幕文本

这次转换会改变什么

有 3 项会被丢弃或需要你决定

  • 样式

    除粗体和斜体之外的全部样式(颜色、描边、阴影、边距)

  • 定位

    屏幕定位(每条字幕条都会回到默认位置)

  • 格式专有内容

    源格式保留在字幕条之外的内容(非字幕块、文件头文字、单条字幕的设置、被注释掉的事件)——目标格式没有地方存放它们

这份清单来自这两种格式的能力矩阵,而不是你加载的这份具体文件。如果具体文件用到了格式允许、但矩阵没有建模的特性,可能会丢得更多。

这一页把 TTML 写成 WebVTT:开头 `WEBVTT`,之后每条 cue 是 `00:00:01.000 --> 00:00:03.500` 加正文。播放器读它的方式与 SRT 接近,时间码用点分隔毫秒。

时间不丢:两边都到毫秒,时钟写法逐字符一致;偏移 `1.5s` 与帧号 `00:00:07:00` 会先按 `ttp:frameRate` 折算成时钟再写出。

丢的是头部与定位:`<styling>` 具名样式表、`<layout>` 具名区域表、`<metadata>`、命名空间,以及 `<p>` 上的 `style` / `region` 引用。注意产物不会把 TTML 的头部翻译成 VTT 自己的 `STYLE` 或 `REGION` 块——那是另一套结构,转换不生成它。段落内部的强调保留为 `<b>`、`<i>`、`<u>`、`<font color="…">` 标签。

`<br/>` 写成换行,两行仍在同一条 cue。产物按开始时间升序,UTF-8、LF、无 BOM;批量串行、可取消、ZIP 打包,不上传。

示例

一份典型的 TTML 文件转成 VTT

输入

<?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>

输出

WEBVTT

00:00:01.000 --> 00:00:03.500
Hello <i>there</i>.

00:00:03.500 --> 00:00:06.000
How are you?
Fine, thanks.

产物丢掉了头部的样式表、区域表与定位引用;段落内的强调以标签保留,时间码精确到毫秒。

同一转换遇到一份脏输入

输入

<?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 &amp; Jerry.</p>
    </div>
  </body>
</tt>

输出

WEBVTT

00:00:01.500 --> 00:00:03.500
Loaded from an offset and a duration.

00:00:04.000 --> 00:00:06.500
A coarser clock spelling.

00:00:07.000 --> 00:00:08.480
Frames, at 25fps.

00:00:09.000 --> 00:00:11.000
<font color="#FF0000">Half-open</font> and Tom &amp; Jerry.

这一份用了真实的写法混排:偏移加时长、粗一点的时钟拼法、按帧号写的时间、实体与只有开始时间的半开 cue。可以看解析器把哪些写法折成了同一份时间轴。

常见问题

TTML 转 VTT 后,`<layout>` 的区域能变成 VTT 的 REGION 吗?

不能。转换不会生成 VTT 的 `REGION` 块;TTML 的 `<layout>` 表与 `region` 引用一起被丢掉,位置由播放器决定。

TTML 转 VTT 的时间码是精确的吗?

是,到毫秒。TTML 的 `00:00:04.126` 与 VTT 的 `00:00:04.126` 一字不差;只有偏移或帧号写法需要先折算。

TTML 转 VTT 后,段落内的斜体与颜色还在吗?

在,写成 `<i>` 与 `<font color="…">` 标签。头部的 `<styling>` 表不保留,所以字体、字号、描边、阴影与边距都会丢。

TTML 的 `style="s1"` 在 VTT 里怎么处理?

丢掉。`s1` 指向 TTML 的 `<styling>` 表,VTT 产物既没有这张表也没有这个引用,只保留文字与行内标签。

TTML 转 VTT 时一条两行字幕怎么写?

时间码下面直接换行,两行都在同一条 cue 里;VTT 没有额外的分组语法。

VTT 再转回 TTML 会丢掉什么?

丢掉格式私有构造。VTT 的 `NOTE`、`STYLE`、`REGION` 块与 cue 设置都不在 TTML 的 cue 模型里;时间与文字能对上。

相关工具