JSON을 VTT로 변환
또는 자막 텍스트를 붙여넣으세요
이 변환에서 달라지는 것
3가지가 버려지거나 결정이 필요합니다
- 스타일
굵게와 기울임을 뺀 모든 스타일(색, 외곽선, 그림자, 여백)
- 위치
화면 위치 지정(모든 자막 블록이 기본 위치로 돌아갑니다)
- 가라오케
가라오케 타이밍(음절 단위 강조)
이 목록은 불러온 특정 파일이 아니라 두 형식의 기능 행렬에서 나옵니다. 어떤 파일은 형식이 허용하지만 행렬이 모델링하지 않는 기능을 쓰고 있다면 더 많이 잃을 수 있습니다.
JSON 자막을 VTT로 옮기면 웹 브라우저가 바로 읽는 자막이 됩니다. 시간은 밀리초까지 유지되고, 줄에 붙은 기울임·굵기·색은 VTT 태그로 남습니다. 다만 styles 객체의 스타일 표, cue 위치, 노래방 표시는 VTT에 자리가 없어 사라집니다.
JSON은 start와 end를 4126 같은 밀리초 정수로 적고, VTT는 같은 순간을 00:00:04.126으로 적습니다. 두 형식 모두 밀리초가 한계라 값이 한 글자도 달라지지 않습니다.
잃는 것은 스타일, 위치, 노래방입니다. styles 객체의 글꼴·크기·색·외곽선·여백과 cue 위치, 노래방 구간이 빠집니다. tags 배열의 강조는 <i>, <font color=…>로 남고, 두 줄 자막은 두 줄로 유지됩니다. VTT의 cue 식별자 줄은 선택 사항이며 재생기 화면에는 나타나지 않습니다.
여러 파일을 한 번에 넣으면 대기열이 차례로 변환하고 결과를 ZIP 하나로 묶습니다. VTT는 텍스트 파일이라 서버 없이 재생되고, 변환도 브라우저 안에서만 이루어집니다.
예시
일반적인 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.
이 결과에서 사라지는 것: 스타일, 위치, 노래방. 나머지는 줄 단위로 같습니다.
까다로운 입력에 같은 변환 적용
입력
[
{ "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로 어떤 스타일이 살아남나요?
줄에 붙은 강조는 살아남습니다. tags 배열의 굵기·기울임·밑줄·색이 <b>, <i>, <u>, <font color=…> 태그로 본문에 적히고 브라우저가 이를 해석합니다. 반면 styles 객체의 스타일 표와 글꼴·크기·외곽선·여백은 VTT에 실리지 않고, 자막을 넣은 페이지의 CSS가 대신 정합니다.
JSON의 화면 위치는 VTT로 넘어가나요?
넘어가지 않습니다. VTT에는 자막을 어디에 그릴지 적는 자리가 없어 cue에 저장된 위치가 버려지고, 모든 자막이 재생기의 기본 위치로 돌아갑니다. 대부분 화면 아래쪽 가운데입니다.
JSON의 노래방 타이밍은 VTT에서 어떻게 되나요?
타이밍은 사라지고 글자는 남습니다. 노래방 정보는 음절이 언제 켜지는지를 적지만 VTT에는 줄 안의 순간을 기록할 방법이 없어 표시가 빠지고 음절은 평범한 텍스트가 됩니다.
JSON을 VTT로 바꾸면 결과가 어떻게 생겼나요?
cue 위에 선택적인 식별자 줄이 붙고, 그 아래 시작·끝 시간과 본문이 옵니다. 식별자 줄은 재생기 화면에 나타나지 않습니다. JSON의 cue 하나가 VTT의 cue 하나가 되며 순서와 글자는 같습니다.
JSON 시간값은 VTT에서 정확한가요?
밀리초까지 정확합니다. JSON의 4126은 VTT의 00:00:04.126이 되고, 반올림이나 이동이 없습니다. 2.9초짜리 자막은 VTT에서도 2.9초입니다.
두 줄짜리 JSON 자막은 VTT에서 어떻게 되나요?
두 줄이 위아래로 그대로 나옵니다. 두 줄이 한 자막이라는 사실이 유지되어 재생기가 함께 보여 주며, 다시 JSON으로 읽어도 한 cue입니다.
JSON cue 순서는 VTT에서도 유지되나요?
유지되고, 변환 과정에서 시작 시간이 이른 순서로 정렬됩니다. JSON 파일이 cue를 뒤섞어 두었다면 VTT 결과에서 순서가 바로잡히며, 이는 내용이 아니라 구조를 바꾸는 일입니다.