Subtitles

OvenMediaEngine 0.19.1 이상 버전부터 API를 사용하여 실시간으로 라이브 스트림에 자막을 삽입할 수 있습니다.

현재는 LL-HLS 및 HLS 퍼블리셔만 지원됩니다. WebRTC는 향후 릴리스에서 지원될 예정입니다.

자막을 활성화하려면, 다음과 같이 <Application> 아래에 Subtitles 섹션을 추가하십시오:

<Subtitles> 설정은 <Application><OutputProfiles><MediaOptions><Subtitles>에서 <Application><Subtitles>로 이동되었습니다. 이에 맞게 기존 설정을 업데이트해 주십시오.

<Application>
    <Name>app</Name>
    <Type>live</Type>

    <Subtitles>
        <Enable>true</Enable>
        <DefaultLabel>Korean</DefaultLabel>
        <Rendition>
            <Language>ko</Language>
            <Label>Korean</Label>
            <AutoSelect>true</AutoSelect>
            <Forced>false</Forced>
        </Rendition>
        <Rendition>
            <Language>en</Language>
            <Label>English</Label>
        </Rendition>
    </Subtitles>
    <OutputProfiles>
        ...
    </OutputProfiles>
</Application>

• DefaultLabel: 플레이어에서 기본 자막 레이블을 설정합니다.

• Language: 언어 코드(ISO 639-1 또는 ISO 639-2)를 정의합니다.

• Label: API를 호출할 때 트랙을 선택하는 데 사용됩니다.

• AutoSelect: true인 경우, 플레이어는 사용자의 언어에 따라 이 트랙을 자동으로 선택할 수 있습니다.

• Forced: true인 경우, 자막이 비활성화되어 있어도 트랙이 항상 표시됩니다(동작은 플레이어에 따라 다름).

Insert Subtitle Cues

자막 트랙이 활성화되면 OvenMediaEngine 자막 API를 사용하여 실시간으로 자막을 삽입할 수 있습니다. 자세한 내용은 API 문서를 참조하십시오.

Send Subtitles

Playlist Subtitle Disable per Playlist

자막이 활성화되면 기본적으로 모든 재생 목록에 자막이 포함됩니다. 특정 재생 목록에 대해 자막을 비활성화하려면 <Playlist><Options><EnableSubtitles>를 false로 설정하십시오(기본값: true).

<Playlist>
	<Name>default</Name>
	<FileName>playlist</FileName>
	<Options>
		<EnableSubtitles>false</EnableSubtitles>
		...
	</Options>