跳至主要內容
SubtitleMatrix

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。

相關工具