跳至主要內容
SubtitleMatrix

JSON 轉 TTML

或者貼上字幕文字

這次轉換會改變什麼

有 1 項會被捨棄或需要你決定

  • 卡拉 OK

    卡拉 OK 計時(逐音節高亮)

這份清單來自這兩種格式的能力矩陣,而不是你載入的這份具體檔案。如果具體檔案用到了格式允許、但矩陣沒有建模的特性,可能會遺失更多。

這一頁把 JSON 字幕檔轉成 TTML。拖入檔案或直接貼上文字,就會拿回 TTML 版本;轉換全程在瀏覽器裡跑,不上傳、也不需要帳號。

兩個格式能存的東西不同,差別不是外觀問題:卡拉OK在 TTML 裡沒有落點。上方清單來自兩個格式各自能表達什麼,不是讀了你的檔案才算出來的,所以檔案還沒載入就已經是這個答案。

本站的 JSON 完整形狀是版本號加一個 cues 陣列,也可以直接是一串 cue;它保留樣式、定位與卡拉OK,這些正是播放器格式常丟掉的。單檔可以,整季也可以:佇列依序處理,結果打包成一個 ZIP。

範例

一份典型的 JSON 檔轉成 TTML

輸入

{
  "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"
    }
  ]
}

輸出

<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling">
  <body>
<p begin="00:00:00.000" end="00:00:02.000">Hello world.<br/>Second line.</p>
<p begin="00:00:02.500" end="00:00:04.000">Plain line.<br/><span tts:fontStyle="italic">Styled</span> line.</p>
<p begin="00:00:04.500" end="00:00:06.000">Roger: I am here.</p>  </body>
</tt>

這份產物丟掉了:卡拉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" }
]

輸出

<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling">
  <body>
<p begin="00:00:00.000" end="00:00:01.000">First.</p>
<p begin="00:00:01.000" end="00:00:02.000">Second.</p>
<p begin="00:00:02.000" end="00:00:03.000">Third.</p>  </body>
</tt>

真實檔案常有混合換行、多餘空白與空欄位,這份輸入就是那個樣子;可以對照上面那份乾淨範例,看看解析器容忍到哪裡。

常見問題

JSON 轉 TTML 時,卡拉OK計時會留下嗎?

時間會丟,字會留。卡拉OK記在 JSON cue 的區間標記裡,標出每個音節何時亮起;TTML 沒有辦法記錄一行之內的時間點,所以標記拿掉,音節變成普通文字。

JSON 轉成 TTML 的產物長什麼樣子?

TTML 沒有編號:每一條字幕是 <p begin="…" end="…"> 元素,放在 <body>(通常還有 <div>)裡,整份檔案上面有 XML 宣告。JSON 的每一條 cue 依序變成一個 <p>。

JSON 轉 TTML 時,時間碼會失真嗎?

不會。JSON 的 4126 毫秒寫成 TTML 的 00:00:04.126,兩邊都是毫秒精度,逐字相同。

JSON 裡同一條字幕的兩行,轉成 TTML 後還綁在一起嗎?

JSON 轉 TTML:還是一條。兩行之間放 <br/>,這在同一個 <p> 裡就是硬換行,播放器會一起顯示。

JSON 的 cue 順序在 TTML 檔裡會重排嗎?

會按開始時間排序,最早的在前。JSON 的每一條字幕進到 TTML 都照這個順序寫;若原檔本來是亂的,產物會把它們排回正確順序——改的是結構,不是內容,這也是本站每個格式共用的讀檔順序。

把 TTML 轉回 JSON,剛才丟掉的東西補得回來嗎?

TTML 轉回 JSON 會丟掉格式私有內容(XML 宣告、body/div 分組、樣式屬性),卡拉OK也補不回來。

JSON 轉 TTML 的產物用什麼編碼與換行?

一律是 UTF-8、Unix 換行(LF)、不帶 BOM,不管 JSON 原檔用什麼。若輸入是 UTF-16 或 Windows 單一位元編碼,讀入時會先解碼,結果面板會說明;TTML 產物永遠是同一種 UTF-8。

相關工具