YouTube timed text

打开保存XMLYouTube

YouTube 播放器读取的 XML:以毫秒计时的字幕,用画笔(pen)设置粗体、斜体、下划线和颜色,用窗口位置决定字幕所在之处。也写作 .ytt,是 YouTube json3 的 XML 形式。Subtitld 能打开它和较早的 srv1,并能保存为 srv3。

概览

扩展名.srv3
媒体类型未注册
规范YouTube 未发布任何规范。它就是 YouTube 播放器所读取的内容,由 YTSubConverter 等写出它的工具加以描述。
时间精度毫秒
文本编码在 XML 中声明。UTF-8。
样式画笔:粗体、斜体、下划线、颜色、字体、大小、边缘和背景
位置窗口位置:一个锚点,以及横向和纵向的位置,以 % 计
说话人无
所在容器无。YouTube 播放器随视频一起获取它;yt-dlp 可以把它保存下来。

文件结构

一个 <timedtext> 文档:head 中是画笔和位置,body 中每条字幕一个段落。下面是 Subtitld 为两条字幕写出的内容,一条带有一个斜体词,另一条位于顶部、显示为黄色:

<timedtext format="3">
<head>
<pen id="1" i="1" />
<pen id="2" fc="#FFFF00" />
<wp id="1" ap="1" ah="50" av="0" />
</head>
<body>
<p t="1000" d="2500">You're a <s p="1">jerk</s>, Thom.</p>
<p t="4000" d="2000" wp="1"><s p="2">Celia!</s>
Wait.</p>
</body></timedtext>
  1. 1 · 根元素

    <timedtext>,格式 3。

  2. 2 · 头部

    带编号的画笔,每支代表一种外观;窗口位置,每个代表屏幕上的一处位置。

  3. 3 · 时间

    每个段落的开始 t 和持续时长 d,以毫秒计。wp 指定它的位置。

  4. 4 · 文本

    字幕内容。<s> 片段使用一支画笔;文本中的换行即是字幕的换行。

时间

不是时间码:而是整数毫秒,一个开始时间和一个时长。

写法 含义
t="4000" 从第 4 秒开始
d="2000" 持续 2 秒:到第 6 秒
没有 d 按 5 秒长读取

画笔与位置

在 head 中 属性 作用
<pen> b、i、u 粗体、斜体、下划线
<pen> fc 文本颜色,#RRGGBB
<pen> fs、sz、et、bc …… 字体、大小、边缘、背景,以及它们的不透明度
<wp> ap 锚点:0 为左上,4 为中心,8 为右下
<wp> ah、av 锚点横向和纵向的位置,以 % 计
<ws> mh …… 窗口样式:文本如何排布、如何滚动

srv3、srv1 还是 json3?

srv3 srv1 json3
写法 XML,<timedtext format="3"> XML,<transcript> JSON
时间 毫秒 秒 毫秒
样式和位置 画笔和位置 无 画笔和位置
在 Subtitld 中 打开和保存 打开 打开

json3 保存的内容与 srv3 相同,只是写成 JSON。Subtitld 以相同的方式读取两者。

Subtitld 中的 YouTube timed text

保留在 .srv3 中
  • 每条字幕的文本和换行
  • 斜体、粗体、下划线和颜色,可用于文本的任何部分
  • 位置:顶部、中部或底部;左、中或右
  • 开始和结束时间,精确到毫秒
无法保存
  • 删除线,以及文字上方的注音
  • 作为说话人的名字,与原文并列的译文
  • 配音、说话人的脸和颜色

如需保留这些内容,请保存为 .usfx 项目。

打开 YouTube timed text 文件

Subtitld 能打开 .srv3、.ytt 和 .srv1,以及根元素为 <timedtext> 或 <transcript> 的 .xml。它会读取:

  • 画笔,作为粗体、斜体、下划线和颜色;白色是播放器的默认颜色,视为无颜色;
  • 窗口位置,作为字幕可以放置的九个位置之一;
  • 自动字幕(逐行滚动),每行一条字幕,各自持续到下一行开始;
  • srv1 的 <text start dur>(以秒计)及其文本,这些文本比 XML 所需多转义了一次。

字体、大小、边缘、背景和不透明度不会读取。如果 .xml 两者都不是,Subtitld 会说明原因。

导出 YouTube timed text

Subtitld 的导出对话框,选中了 XML,说话人名字写在文本前,保留格式

在 导出 中选择 字幕 和 XML,会提供以下选项:

  • 文本原文、译文,或两者都要,译文位于原文之下。
  • 说话人名字不写,或写在文本前(Thom: ……)。
  • 格式保留,或去除。去除时,位置也一并去除。
  • 时间偏移所有字幕整体提前或推迟相同的时长。

Subtitld 以 UTF-8 写出 .srv3 格式的 srv3:文本用到的每种外观对应一支画笔,除底部居中(播放器的默认位置)以外的每个位置对应一个窗口位置,每条字幕对应一个段落,按开始时间排序。空字幕不会写出。

小知识

不在列表中

YouTube 的帮助页面列出了它接受的字幕文件:SubRip、SBV、LRC、WebVTT、TTML、SCC 等。它自己的 timed text 却不在其中。

.ytt

YTSubConverter 把 ASS 字幕转换为 srv3,并命名为 .ytt,为 YouTube 自身的字幕带来样式、位置和卡拉 OK 效果。

Ruby

srv3 还能携带文字上方的注音和竖排文本。YTSubConverter 根据它自己的 ASS 标签 {\ytruby} 和 {\ytvert} 写出这些内容。

相关格式

有 .srv3 需要修正吗?

在 Subtitld 中打开它,连同视频一起,在波形上重新打轴。

下载 Subtitld