跳至主要內容
SubtitleMatrix

JSON 轉 ASS

或者貼上字幕文字

這次轉換會改變什麼

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

  • 精確度

    時間精確度——輸出的時間刻度較粗,因此每個時間戳記都會四捨五入到最接近的 10 毫秒

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

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

兩個格式能存的東西不同,差別不是外觀問題:比 10 毫秒更細的時間精度在 ASS 裡沒有落點。上方清單來自兩個格式各自能表達什麼,不是讀了你的檔案才算出來的,所以檔案還沒載入就已經是這個答案。

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

範例

一份典型的 JSON 檔轉成 ASS

輸入

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

輸出

[Script Info]
Title: Fixture: typical
ScriptType: v4.00+

[V4+ Styles]
Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding
Style: Default,Arial,20,&H00FFFFFF,,,,0,0,,,,,,,,,,,,,,

[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: 0,0:00:00.00,0:00:02.00,Default,,0,0,0,,{\pos(100,200)}Hello world.\NSecond line.
Dialogue: 0,0:00:02.50,0:00:04.00,Default,,0,0,0,,Plain line.\N{\i1}Styled{\i0} line.
Dialogue: 0,0:00:04.50,0:00:06.00,Default,,0,0,0,,Roger: I am here.

這份產物丟掉了:時間精度(僅到 10 毫秒)。其餘內容逐行對得上。

同一轉換遇到結構鬆散的 JSON 輸入

輸入

[
    { "start": 0, "end": 1000, "lines": ["First."] },
    { "start": 1000, "end": 2000, "text": "Second." },
    "not an object",
    { "start": 2000, "end": 3000, "lines": ["Third."], "class": "top" }
]

輸出

[Script Info]
ScriptType: v4.00+

[V4+ Styles]
Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, OutlineColour, BackColour, Bold, Italic, Underline, StrikeOut, ScaleX, ScaleY, Spacing, Angle, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, Encoding
Style: Default,Arial,20,&H00FFFFFF,&H000000FF,&H00000000,&H00000000,0,0,0,0,100,100,0,0,1,2,2,2,10,10,10,1

[Events]
Format: Layer, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: 0,0:00:00.00,0:00:01.00,Default,,0,0,0,,First.
Dialogue: 0,0:00:01.00,0:00:02.00,Default,,0,0,0,,Second.
Dialogue: 0,0:00:02.00,0:00:03.00,Default,,0,0,0,,Third.

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

常見問題

JSON 轉 ASS 時,毫秒為什麼會變成百分之一秒?

ASS 的時間寫成 0:00:04.13,只到百分之一秒;JSON 是毫秒,所以每個時間碼四捨五入到 10 毫秒,4,126 毫秒會變成 4.13 秒。任何一條 cue 的位移都不超過 5 毫秒,也不會重排。

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

ASS 沒有 cue 編號:每一條字幕都是 [Events] 段裡的一行 Dialogue:,原本放編號的位置換成 Layer 欄位。JSON 的每一條 cue 依序變成一行,文字不變。

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

JSON 轉 ASS:還是一條。兩行之間用 \N 接起來,這是 ASS 的硬換行寫法;播放器會把它們當同一條字幕一起顯示。

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

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

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

精度補不回來:ASS 只存到百分之一秒,轉回 JSON 時拿到的就是四捨五入後的時間。此外 ASS 轉 JSON 還會丟掉格式私有內容([Script Info] 全域設定、內嵌字型與圖形、Comment: 事件),那是另一份清單。

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

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

相關工具