# Subtitles

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

<figure><img src="/files/tWP4OM15JafphTE74Zah" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/An7dBIy7CIhw1n4Scu8s" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
현재는 LL-HLS 및 HLS 퍼블리셔만 지원됩니다. WebRTC는 향후 릴리스에서 지원될 예정입니다.
{% endhint %}

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

{% hint style="warning" %}
`<Subtitles>` 설정은 `<Application><OutputProfiles><MediaOptions><Subtitles>`에서 `<Application><Subtitles>`로 이동되었습니다. 이에 맞게 기존 설정을 업데이트해 주십시오.
{% endhint %}

```xml
<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 문서를 참조하십시오.

{% content-ref url="/pages/FNamKA0KFmsAOgTt90V0" %}
[Send Subtitles](/guide/ko-kr/features/rest-api/v1/virtual-host/application/stream/send-subtitles.md)
{% endcontent-ref %}

### Playlist Subtitle Disable per Playlist

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ovenmediaengine-enterprise.gitbook.io/guide/ko-kr/features/transcoding-and-processing/subtitles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.