JSON 轉 VTT
或者貼上字幕文字
這次轉換會改變什麼
有 3 項會被捨棄或需要你決定
- 樣式
除粗體與斜體之外的全部樣式(顏色、外框、陰影、邊界)
- 定位
螢幕定位(每條字幕都會回到預設位置)
- 卡拉 OK
卡拉 OK 計時(逐音節高亮)
這份清單來自這兩種格式的能力矩陣,而不是你載入的這份具體檔案。如果具體檔案用到了格式允許、但矩陣沒有建模的特性,可能會遺失更多。
這一頁把 JSON 字幕檔轉成 VTT。拖入檔案或直接貼上文字,就會拿回 VTT 版本;轉換全程在瀏覽器裡跑,不上傳、也不需要帳號。
兩個格式能存的東西不同,差別不是外觀問題:樣式、定位與卡拉OK在 VTT 裡沒有落點。上方清單來自兩個格式各自能表達什麼,不是讀了你的檔案才算出來的,所以檔案還沒載入就已經是這個答案。
本站的 JSON 完整形狀是版本號加一個 cues 陣列,也可以直接是一串 cue;它保留樣式、定位與卡拉OK,這些正是播放器格式常丟掉的。單檔可以,整季也可以:佇列依序處理,結果打包成一個 ZIP。
範例
一份典型的 JSON 檔轉成 VTT
輸入
{
"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"
}
]
}
輸出
WEBVTT
1
00:00:00.000 --> 00:00:02.000
Hello world.
Second line.
2
00:00:02.500 --> 00:00:04.000
Plain line.
<i>Styled</i> line.
3
00:00:04.500 --> 00:00:06.000
Roger: I am here.
這份產物丟掉了:樣式、定位與卡拉OK。其餘內容逐行對得上。
同一轉換遇到結構鬆散的 JSON 輸入
輸入
[
{ "start": 0, "end": 1000, "lines": ["First."] },
{ "start": 1000, "end": 2000, "text": "Second." },
"not an object",
{ "start": 2000, "end": 3000, "lines": ["Third."], "class": "top" }
]
輸出
WEBVTT
00:00:00.000 --> 00:00:01.000
First.
00:00:01.000 --> 00:00:02.000
Second.
00:00:02.000 --> 00:00:03.000
Third.
真實檔案常有混合換行、多餘空白與空欄位,這份輸入就是那個樣子;可以對照上面那份乾淨範例,看看解析器容忍到哪裡。
常見問題
JSON 轉 VTT 時,粗體、斜體與顏色會留下嗎?
行內強調會留下,樣式表不會。粗體、斜體、底線與顏色會寫成 VTT 文字裡的標籤(<i>、<b>、<u>、<font color="…">),這是 cue 層級格式還帶得動的部分;JSON 檔的全域樣式表——字型、字號、描邊、陰影與邊距——則整份丟掉。
JSON 轉 VTT 時,螢幕上的位置會被保留嗎?
VTT 不能指定字幕畫在哪裡,所以每條 cue 儲存的位置在轉出時丟掉,播放器會回到它自己的預設位置——大多數播放器是畫面底部置中。
JSON 轉 VTT 時,卡拉OK計時會留下嗎?
時間會丟,字會留。卡拉OK記在 JSON cue 的區間標記裡,標出每個音節何時亮起;VTT 沒有辦法記錄一行之內的時間點,所以標記拿掉,音節變成普通文字。
JSON 轉成 VTT 的產物長什麼樣子?
VTT 的每一條字幕可以有一行識別碼(播放器不顯示),接著是時間碼與正文。JSON 的每一條 cue 依序變成一條。
JSON 轉 VTT 時,時間碼會失真嗎?
不會。JSON 的 4126 毫秒寫成 VTT 的 00:00:04.126,兩邊都是毫秒精度,時間軸不會漂移。
JSON 裡同一條字幕的兩行,轉成 VTT 後還綁在一起嗎?
JSON 轉 VTT:還是一條。兩行直接上下排列,中間不空行;播放器會把它們當同一條字幕的兩行。
JSON 的 cue 順序在 VTT 檔裡會重排嗎?
會按開始時間排序,最早的在前。JSON 的每一條字幕進到 VTT 都照這個順序寫;若原檔本來是亂的,產物會把它們排回正確順序——改的是結構,不是內容,這也是本站每個格式共用的讀檔順序。
把 VTT 轉回 JSON,剛才丟掉的東西補得回來嗎?
VTT 轉回 JSON 會丟掉格式私有內容(NOTE/STYLE/REGION 與 align 設定),樣式、定位與卡拉OK也沒有紀錄可還原。
JSON 轉 VTT 的產物用什麼編碼與換行?
一律是 UTF-8、Unix 換行(LF)、不帶 BOM,不管 JSON 原檔用什麼。若輸入是 UTF-16 或 Windows 單一位元編碼,讀入時會先解碼,結果面板會說明;VTT 產物永遠是同一種 UTF-8。