자막

이 페이지는 문서 버전에 해당하는 project.v1.schema.json에서 자동 생성되며, 필드 설명은 원문(영어) 그대로입니다. 스키마는 형태만 검사합니다. 범위, 한도, 참조, 키프레임 순서는 엔진 검증 단계에서 검사합니다.

Text shown over one timeline interval.

Field	Type	Description
`speaker`	string \| null	Who says it, as the source names them (a WebVTT voice), at most 64 bytes. A track style of that name applies when the cue names no style.
`style`	string \| null	The name of one of the track's `styles`, applied over its style.
`text`required	TextContent	The text, a string or runs; `\n` starts a line. Non-empty, at most `MAX_TEXT_CONTENT_BYTES` bytes. Run times are from the cue's start and lie within it.
`timeline_range`required	TimeRange	When the cue shows. Non-empty and not before zero.

What a caption track shows: its cues, in its style.

Field Type Description

Field	Type	Description
`cues`required	CaptionCue[]	Cues in timeline order, none overlapping; a track shows one cue at a time.
`style`	TextStyle	The style every cue starts from. Default: `{"align":"center","anchor":{"x":0.5,"y":1},"background":n…`
`styles`	{ [name]: TextStylePatch }	Named changes to `style` for cues that name one or whose speaker has one. At most `MAX_CAPTION_STYLES`, names 1 to 64 bytes.

cuesrequired

Cues in timeline order, none overlapping; a track shows one cue at a time.

style

The style every cue starts from.

Default: {"align":"center","anchor":{"x":0.5,"y":1},"background":n…

styles

Named changes to style for cues that name one or whose speaker has one. At most MAX_CAPTION_STYLES, names 1 to 64 bytes.