Thumbnail

OvenMediaEngine은 라이브 스트림에서 썸네일을 생성할 수 있습니다. 이를 통해 웹사이트에서 방송 목록을 구성하거나 여러 스트림을 동시에 모니터링할 수 있습니다.

Configuration

Bind

썸네일은 HTTP(s)를 통해 퍼블리싱됩니다. 썸네일을 위한 포트를 다음과 같이 설정합니다. 썸네일 퍼블리셔는 HLS 및 DASH와 동일한 포트 번호를 사용할 수 있습니다.

<Bind>
    <Publishers>
      ...
        <Thumbnail>
            <Port>20080</Port>
            <!-- If you need TLS support, please uncomment below:
            <TLSPort>20081</TLSPort>
            -->
        </Thumbnail>
    </Publishers>
</Bind>

Encoding

썸네일을 퍼블리싱하려면 인코딩 프로필을 설정해야 합니다. 포맷으로 JPG, PNG, WEBP를 선택할 수 있습니다. 프레임 레이트(Framerate)와 해상도(Resolution)를 설정할 수 있습니다. 아래의 샘플을 참조해 주십시오.

<OutputProfiles>
    <OutputProfile>
        <Name>default_stream</Name>
        <OutputStreamName>${OriginStreamName}_preview</OutputStreamName>
        <Encodes>
            <Image>
                <Codec>jpeg</Codec>
                <Framerate>1</Framerate>
                <Width>1280</Width>
                <Height>720</Height>
            </Image>
            <Image>
                <Codec>png</Codec>
                <Framerate>1</Framerate>
                <Width>1280</Width>
                <Height>720</Height>
            </Image>
            <Image>
                <Codec>webp</Codec>
                <Framerate>1</Framerate>
                <Width>1280</Width>
                <Height>720</Height>
            </Image>            
        </Encodes>
    </OutputProfile>
</OutputProfiles>

Property	Description
Codec	사용할 이미지 코덱을 지정합니다.
Width	해상도의 너비(가로)
Height	해상도의 높이(세로)
Framerate	초당 프레임 수

Supported image codecs

Encode Type	Codec	Codec of Configuration
Image	JPEG	jpeg
	PNG	png
	WEBP	webp

이미지 인코딩 프로필은 썸네일 퍼블리셔에서만 사용되며, bypass 옵션은 지원되지 않습니다.

Publisher

썸네일 퍼블리셔를 선언합니다. 크로스 도메인(Cross-domain) 설정은 세부 옵션으로 사용할 수 있습니다.

<Publishers>
    ...
    <Thumbnail>
        <CrossDomains>
            <Url>*</Url>
        </CrossDomains>	
    </Thumbnail>
</Publishers>

Get thumbnails

썸네일에 대한 설정이 완료되고 스트림이 입력되면, 다음 URL을 통해 썸네일을 확인할 수 있습니다.

Method	URL Pattern
GET	http(s)://<ome_host>:<port>/<app_name>/<output_stream_name>/thumb.<jpg|png|webp>

Advanced

Keyframes Decoding Only

비디오 (재)인코딩이 필요 없는 사용 사례를 위해, OME는 수신되는 스트림의 키프레임만 디코딩하도록 설정할 수 있습니다. 썸네일을 생성하기 위한 목적으로만 인코더를 사용하는 경우, 이는 엄청난 성능 향상을 가져옵니다.

지원 버전: OvenMediaEngine 0.17.2 이상

<OutputProfiles>
<!-- Common setting for decoders. Decodes is optional. -->
	<Decodes>
	<!-- 
	By default, OME decodes all video frames. 
	With OnlyKeyframes, only keyframes are decoded,
	massively improving performance.
	Thumbnails are generated only on keyframes,
	they may not generate at your requested fps!
	-->
		<OnlyKeyframes>true</OnlyKeyframes>
	</Decodes>

    <OutputProfile>
       <Encodes>
           <Video>
                <Bypass>true</Bypass>	
  		   </Video>
           <Image>
               <Codec>jpeg</Codec>
               <Width>1280</Width>
               <Height>720</Height>
               <Framerate>1</Framerate>
          </Image>
       </Encodes>
    </OutputProfile>
</OutputProfiles>

CrossDomains

CrossDomains에 대한 자세한 정보는 CrossDomains 챕터를 참조해 주십시오.