WebVTT in HTTP Live Streaming
Apple의 HTTP Live Streaming이 자막을 싣는 방식입니다. 재생 목록 하나와, 그 목록에 적힌 WebVTT 파일들로 이루어지며, 각 파일은 프로그램의 몇 초 분량입니다. 플레이어는 재생하면서 영상 자체의 세그먼트와 함께 이 파일들을 받아 옵니다.
한눈에 보기
| 확장자 | .m3u8 |
|---|---|
| 미디어 타입 | 재생 목록: application/vnd.apple.mpegurl. 세그먼트: text/vtt. |
| 사양 | RFC 8216(2017), 그리고 Apple의 HLS Authoring Specification for Apple Devices. 세그먼트는 WebVTT입니다. |
| 시간 정밀도 | 밀리초, 세그먼트의 큐에서 |
| 텍스트 인코딩 | UTF-8, 재생 목록과 세그먼트 모두 |
| 스타일 | WebVTT의 것: 기울임, 굵게, 밑줄, 클래스로 지정하는 색 |
| 위치 지정 | WebVTT의 큐 설정 |
| 화자 | WebVTT의 음성 태그: <v Thom> |
| 컨테이너 안 | WebVTT는 없음: 웹 서버의 일반 텍스트 파일입니다. HLS의 IMSC 자막은 조각화된 MP4로 옵니다. |
재생 목록의 구조
세그먼트 목록이며, 각 세그먼트에 길이가 붙습니다. 자막은 목록이 가리키는 파일들에 들어 있습니다.
#EXTM3U #EXT-X-VERSION:3 #EXT-X-TARGETDURATION:6 #EXT-X-MEDIA-SEQUENCE:0 #EXT-X-PLAYLIST-TYPE:VOD #EXTINF:6.000, movie_segments/segment00000.vtt #EXTINF:6.000, movie_segments/segment00001.vtt #EXTINF:2.000, movie_segments/segment00002.vtt #EXT-X-ENDLIST
- 1 · 헤더
언제나
#EXTM3U가 먼저 옵니다. 그다음 버전, 첫 세그먼트의 번호, 그리고VOD: 세그먼트가 모두 갖춰진 프로그램. - 2 · 목표 길이
어떤 세그먼트의 길이도 반올림해서 넘지 않는 정수 초.
- 3 · 길이
뒤따르는 세그먼트가 이어지는 초.
- 4 · 주소
세그먼트가 있는 곳: 여기서는 재생 목록 옆, 또는 웹 주소.
- 5 · 끝
더 올 것이 없다는 표시. 라이브 스트림은 이를 빼고 세그먼트를 계속 더합니다.
세그먼트의 구조
각 세그먼트는 독립된 WebVTT 파일이며, 헤더에 한 줄이 더 있습니다.
WEBVTT X-TIMESTAMP-MAP=LOCAL:00:00:00.000,MPEGTS:900000 00:00:04.000 --> 00:00:07.500 <v Celia>You're a jerk, Thom. 00:00:08.000 --> 00:00:09.600 <v Thom><i>Celia!</i>
- 1 · 헤더
다른 WebVTT 파일과 같은
WEBVTT. - 2 · 타임스탬프 맵
큐 시간이 영상의 어느 순간을 뜻하는지.
- 3 · 큐
세그먼트 동안 보이는 모든 큐. 세그먼트 밖의 부분까지 포함한 전체 시간이 붙습니다.
이것은 6초부터 12초까지의 두 번째 세그먼트입니다. 첫 큐는 첫 세그먼트의 4초에서 시작했고 두 세그먼트 모두에 들어 있으므로, 여기서 재생을 시작하는 플레이어도 이 큐를 보여 줍니다.
타임스탬프 맵
영상의 프레임에는 초당 90,000틱 클록으로 센 MPEG-2 타임스탬프가 붙습니다. 맵은 두 시계를 이어 줍니다.
| 부분 | 의미 |
|---|---|
LOCAL:00:00:00.000 |
이 파일의 큐 시간 |
MPEGTS:900000 |
그 시간에 해당하는 영상의 타임스탬프: 900,000틱, 10초 |
많은 인코더가 스트림의 클록을 10초에서 시작하므로 900000이 흔한 값입니다. 맵이 이러면 00:00:04.000의 큐는 1,260,000이 찍힌 프레임과 함께 보입니다. 맵이 없는 세그먼트는 0을 0에 잇는 것으로 읽습니다.
맵이 틀리면 모든 자막이 밀립니다. 영상의 클록이 10초에서 시작하는데 맵이 0이라고 하면, 플레이어는 자막을 10초 늦게 보여 주거나 아예 보여 주지 않습니다. 영상의 인코더가 쓴 값을 적으세요.
스트림 전체 속의 자막
스트림의 메인 재생 목록은 렌디션들을 나열합니다. 여러 크기의 영상, 오디오, 언어별 자막이 각자의 재생 목록을 가집니다.
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",NAME="English",LANGUAGE="en",DEFAULT=YES,URI="en.m3u8"
| 속성 | 담는 것 |
|---|---|
TYPE |
SUBTITLES |
LANGUAGE |
자막의 언어, BCP 47 태그 |
DEFAULT |
시청자가 아무것도 고르지 않았을 때 보여 줄 자막이면 YES |
URI |
위와 같은 자막 자체의 재생 목록 |
HLS인가, WebVTT 파일인가?
| WebVTT 파일 | HLS | |
|---|---|---|
| 파일 | 하나 | 재생 목록 하나와 몇 초마다 세그먼트 하나 |
| 보여 주는 곳 | 웹 페이지의 <track>, 플레이어 |
HLS 플레이어: Safari, iPhone, Apple TV, 그리고 웹의 hls.js |
| 영상에 묶는 방법 | 처음부터의 시간 | 영상 자체의 타임스탬프에 대한 타임스탬프 맵 |
| 라이브 | — | 프로그램이 진행되면서 세그먼트가 더해짐 |
Subtitld의 HLS
- 모든 자막의 텍스트와 줄바꿈
- 기울임, 굵게, 밑줄, 색, WebVTT가 유지하는 대로
- 위치, 큐 설정으로
- 화자, 음성 태그로
- 밀리초 단위의 시작과 끝
- 언어: Subtitld는 자막의 재생 목록을 쓰며, 언어를 밝히는 메인 재생 목록은 쓰지 않습니다
- 원문 옆의 번역
- 더빙, 화자의 얼굴과 색
이것들을 보존하려면 .usfx 프로젝트로 저장하세요.
HLS 재생 목록 열기
.m3u8 파일을 여세요. Subtitld는 다음과 같이 합니다.
- 메인 재생 목록이면 자막까지 따라감: 프로젝트 언어의 렌디션, 없으면 기본 렌디션, 없으면 첫 렌디션;
- 재생 목록에 적힌 각 세그먼트를 읽음. 옆에 있든
http나https주소에 있든, 바이트 범위가 가리키는 파일의 일부까지; - 세그먼트를 WebVTT로 읽고, 스트림의 첫 순간이 0이 되도록 각각을 타임스탬프 맵만큼 옮김;
- 여러 세그먼트에 걸쳐 반복되는 큐는 한 번만 남기고, 세그멘터가 세그먼트 경계에서 둘로 자른 큐는 이어 붙임;
- CMAF가 싣는 대로 조각화된 MP4 속 IMSC 세그먼트를 읽음;
- 렌디션의 언어를 프로젝트의 언어로.
#EXTM3U로 시작하지 않는 파일이나 자막이 없는 재생 목록이면 그렇다고 알립니다.
HLS 내보내기
내보내기를 누른 다음 자막과 HLS를 선택하면 다음 항목이 나옵니다.
- 텍스트원문, 번역, 또는 둘 다. 번역은 원문 아래에 놓입니다.
- 화자 이름빼거나, 텍스트 앞에 쓰거나(Thom: …), 음성 태그(
<v Thom>)로 씁니다. - 서식유지하거나, 제거합니다.
- 시간 이동모든 자막을 같은 양만큼 앞이나 뒤로 옮깁니다.
- 세그먼트 길이2, 4, 6, 10초. Apple은 6초를 권장합니다.
- 타임스탬프 맵대부분의 인코더가 스트림의 클록을 시작하는 10초인
MPEGTS:900000, 또는MPEGTS:0.
Subtitld는 버전 3 재생 목록과, 그 옆에 재생 목록 이름을 딴 폴더(movie.m3u8, movie_segments)를 쓰고, 폴더에 segment00000.vtt부터 세그먼트를 넣습니다. 마지막을 뺀 모든 세그먼트는 길이가 같고, 맵도 같으므로 큐 시간이 곧 프로그램의 시간입니다. 세그먼트는 빈 것까지 포함해 영상 길이만큼, 영상이 없으면 자막 길이만큼 이어집니다. 다시 저장하면 폴더의 세그먼트가 바뀝니다.
스트림의 메인 재생 목록에 언어와 주소를 적은 #EXT-X-MEDIA:TYPE=SUBTITLES 줄로 이 재생 목록을 추가하세요.
알아두면 좋은 사실
Apple은 2009년 5월 HTTP Live Streaming을 내놓았습니다. 여러 해 동안 인터넷 드래프트로 있다가 2017년 8월 RFC 8216으로 공개되었습니다.
MPEG-2 타임스탬프의 90,000틱 클록이 33비트를 다 써서 0으로 돌아가기까지 걸리는 시간입니다. RFC 8216은 그때 큐 시간이 계속 이어지도록 플레이어가 대처하라고 요구합니다.
Apple의 저작 사양은 목표 길이를 6초로 하고, WebVTT 자막에는 반드시 타임스탬프 맵이 있어야 한다고 말합니다.
관련 형식
Subtitld에서 동영상과 함께 열고, 파형에서 시간을 다시 맞춰 보세요.