TTML 轉 JSON
或者貼上字幕文字
這次轉換會改變什麼
有 1 項會被捨棄或需要你決定
- 格式專屬內容
來源格式保留在字幕之外的內容（非字幕區塊、檔案標頭文字、單條字幕的設定、被註解掉的事件）——目標格式沒有地方存放它們
這份清單來自這兩種格式的能力矩陣，而不是你載入的這份具體檔案。如果具體檔案用到了格式允許、但矩陣沒有建模的特性，可能會遺失更多。
這一頁把 TTML 寫成 JSON：頂層是 `version` 與 `cues`，每條 cue 有 `start`、`end`（整數毫秒）與 `lines`；`<br/>` 拆成兩筆行記錄，仍然屬於同一條 cue。時間 `00:00:04.126` 寫成 `4126`。
TTML 與 JSON 之間真正「結構化」的一層是段落內的強調：`<span tts:fontStyle="italic">there</span>` 會落成該行的 `tags` 陣列，帶 `kind`、`start`、`end`，顏色還會帶 `value`（例如 `#FF0000`）。文字本身不變，標籤是相對文字區間的標注。
丟的是頭部：XML 宣告與命名空間、`<styling>` 表、`<layout>` 表、`<metadata>`，以及 `<p>` 上的 `style` / `region` 參照。JSON 輸出裡有 `styles` 物件，但沒有任何頭部定義被翻譯進去，所以它是空的；頭部資訊不會偽裝成結構化欄位。產物依開始時間升序，UTF-8、LF、無 BOM。
範例
一份典型的 TTML 檔轉成 JSON
輸入
<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling" xml:lang="en">
<head>
<styling>
<style xml:id="s1" tts:color="#FFFF00" tts:fontWeight="bold"/>
</styling>
<layout>
<region xml:id="bottom" tts:origin="10% 80%" tts:extent="80% 20%"/>
</layout>
</head>
<body>
<div>
<p begin="00:00:01.000" end="00:00:03.500" region="bottom" style="s1">Hello <span tts:fontStyle="italic">there</span>.</p>
<p begin="00:00:03.500" end="00:00:06.000" region="bottom">How are you?<br/>Fine, thanks.</p>
</div>
</body>
</tt>
輸出
{
"version": 1,
"cues": [
{
"start": 1000,
"end": 3500,
"lines": [
{
"text": "Hello there.",
"tags": [
{
"kind": "italic",
"start": 6,
"end": 11
}
]
}
]
},
{
"start": 3500,
"end": 6000,
"lines": [
"How are you?",
"Fine, thanks."
]
}
]
}
這個方向丟掉 TTML 頭部（樣式表、區域表、命名空間）；段落內的強調以結構化標籤保留。
同一轉換遇到一份格式凌亂的檔案
輸入
<?xml version="1.0" encoding="UTF-8"?>
<tt xmlns="http://www.w3.org/ns/ttml" xmlns:tts="http://www.w3.org/ns/ttml#styling"
xmlns:ttp="http://www.w3.org/ns/ttml#parameter"
ttp:frameRate="25" xml:lang="en">
<body>
<div>
<p begin="1.5s" dur="2s">Loaded from an offset and a duration.</p>
<p begin="4s" end="00:00:06.50">A coarser clock spelling.</p>
<p begin="00:00:07:00" end="00:00:08:12">Frames, at 25fps.</p>
<p begin="9s"><span tts:color="#FF0000">Half-open</span> and Tom & Jerry.</p>
</div>
</body>
</tt>
輸出
{
"version": 1,
"cues": [
{
"start": 1500,
"end": 3500,
"lines": [
"Loaded from an offset and a duration."
]
},
{
"start": 4000,
"end": 6500,
"lines": [
"A coarser clock spelling."
]
},
{
"start": 7000,
"end": 8480,
"lines": [
"Frames, at 25fps."
]
},
{
"start": 9000,
"end": 11000,
"lines": [
{
"text": "Half-open and Tom & Jerry.",
"tags": [
{
"kind": "color",
"start": 0,
"end": 9,
"value": "#FF0000"
}
]
}
]
}
]
}
這一份混用了真實寫法：位移加時長、較粗的時鐘拼法、按影格寫的時間、實體，以及只有開始時間的半開 cue。可以看解析器把哪些寫法折進同一條時間軸。
常見問題
TTML 轉 JSON 後，`<span>` 的斜體和顏色怎麼表示？
寫成該行的 `tags` 陣列：斜體是 `{"kind":"italic","start":6,"end":11}`，顏色是 `{"kind":"color",…,"value":"#FF0000"}`。區間是相對於文字本身的位移。
TTML 轉 JSON 的 `styles` 物件為什麼是空的？
因為頭部的 `<styling>` 表沒有被翻譯進去。JSON 有 `styles` 這個欄位，但 TTML 的具名樣式屬於格式私有構造，這一頁不把它們改寫成 JSON 的樣式物件。
TTML 轉 JSON 時毫秒會四捨五入嗎？
不會。TTML 的 `00:00:04.126` 寫成整數 `4126`，兩邊都是毫秒；只有位移與影格寫法需要先折算成毫秒。
TTML 轉 JSON 後，一條兩行字幕怎麼表示？
`lines` 陣列裡兩筆記錄，順序不變。它仍然是一條 cue，時間欄位只有一對 `start` / `end`。
TTML 的 `region` 在 JSON 裡有欄位嗎？
沒有。`region` 是對 `<layout>` 表的參照，屬於頭部；JSON 的 cue 只保留時間、文字與行內標籤，不保留畫面位置。
JSON 再轉回 TTML 會丟掉什麼？
丟掉卡拉 OK 計時。JSON 能帶行內標籤，但 TTML 的 cue 模型沒有逐字計時這一維；其餘時間與文字可以對上。
TTML 轉 JSON 的產物用什麼編碼？
UTF-8、LF、無 BOM。來源若是 UTF-16 或 Windows 單一位元編碼，會先解碼並在結果面板說明。