와우자 서버 리스너를 이용한 파일 기반 라이브 스트림 생성

Step 1 – 사전 준비

구성을 시작하기 전, 아래와 같은 항목들이 먼저 준비되어 있어야 한다.

• 라이브 어플리케이션

  스트림을 송출하는 데 사용할 와우자 라이브 어플리케이션이 만들어져 있어야 한다.

• 스트림 생성을 위해 재생할 콘텐츠 파일

  사용 가능한 파일 포맷 형식의 콘텐츠 파일로, 정당한 사용 권한을 가지고 있어야 한다. 복수의 파일을 사용할 경우 파일의 포맷이 동일한 것이 좋다. 여기서 말하는 파일의 포맷이란 단지 확장자를 말하는 것이 아니다. 코덱, 샘플레이트, 해상도, FPS, 프로파일, GOP 사이즈 등 상세 규격을 의미한다.

• 콘텐츠 파일 업로드

  사용할 콘텐츠 파일을 와우자의 콘텐츠 디렉토리에 업로드해 두어야 한다. 각 기본 콘텐츠 디렉토리 경로는 다음과 같다.

  윈도우

  C:\Program Files\Wowza Media Systems\Wowza Streaming Engine (버전)\content

  리눅스

  /usr/local/WowzaStreamingEngine-(버전)/content

  본 필자는 WinSCP를 이용해 스트리밍에 사용할 1.mp3, 2.mp3, 3.mp3 3개의 파일을 업로드했다.

  

Step 2 – 서버 리스너 클래스 등록

서버 리스너 클래스(Server Listener Class)는 와우자의 동작을 제어하는 트리거 역할을 한다. 이 클래스는 특정 어플리케이션이 아닌 와우자 서버 전역에서 동작하는 클래스로, 와우자의 동작을 제어할 수 있다.

1. 와우자 웹 UI에 접속해 상단의 Server 메뉴를 선택하고, 왼쪽에서 Server Setup을 선택한다.
2. 상단의 Server Listeners 탭을 선택하면 현재 설정된 서버 리스너의 목록이 표시된다.
3. Edit 버튼을 클릭하고 Add Server Listeners 버튼을 클릭해 서버 리스너 추가 창을 띄운다.

   

4. Base Class 항목에 com.wowza.wms.module.ServerListenerStreamDemoPublisher를 입력해 주고 Add 버튼을 클릭해 준다.

   

5. Save 버튼을 클릭해 클래스가 추가된 것을 확인하고 Restart Now 버튼을 클릭해 와우자 서비스를 재시작한다.

   

Step 3 – 서버 프로퍼티 등록

서버 프로퍼티(Server Properties)는 와우자 엔진이 동작하는 데 필요한 설정값들을 변경하는 부분으로, 위에서 설정한 서버 리스너가 어떤 방식으로 동작할지 정의하는 부분이다.

1. 재시작된 와우자 엔진의 웹 UI에 다시 접속한다. Server 메뉴를 선택하고, 왼쪽에서 Server Setup을 선택한 후, Properties 탭을 선택한다. 현재 설정된 와우자 엔진의 설정값들이 표시된다.

   

2. 제일 아래에 위치한 Custom 항목의 Edit 버튼을 클릭해 프로퍼티 추가 메뉴에 진입하면 현재 설정된 사용자 프로퍼티 설정값 목록이 표시된다.
3. Add Custom Property 버튼을 클릭해 Add Custom Property 창을 열어 아래와 같이 입력해 준다.

   

   Path

   /Root/Server

   Name

   streamDemoPublisherConfig

   Type

   String

   Value

   아래, streamDemoPublisherConfig의 Value 설정참고

   Value 항목은 해당 서버 리스너의 동작 방식을 제어하는 가장 중요한 설정값이며, 이에 대한 자세한 작성 방법은 아래 Step 4에서 설명한다.

Step 4 – streamDemoPublisherConfig의 Value 설정

Value는 등록한 streamDemoPublisherConfig 의 동작을 정의하는 부분으로 아래와 같은 형태로 사용한다.

appName=FileToLive,srcStream=m3u8:lst.m3u8,dstStream=MusicBox

이를 각 구성요소별로 분리해 보면 다음과 같이 정리할 수 있다.

프로퍼티

적색 부분, 설정 항목

appName, srcStream, dstStream

값

청색 부분, 프로퍼티에 적용할 값

FileToLive, m3u8:lst.m3u8, MusicBox

연결자

황색으로 표시된 =는 프로퍼티와 값을 연결해 준다

구분자

둘 이상의 프로퍼티를 선언할 경우 ,로 구분해 준다.

streamDemoPublisherConfig의 프로퍼티 중 자주 사용되는 것과 의미는 다음과 같다.

appName

이 스트림을 생성할 어플리케이션의 이름

dstStream

생성될 스트림의 이름

playlistRepeat

true일 경우 반복 재생, false일 경우 반복 재생 안함

random

true일 경우 재생목록을 무작위로 재생

sendOnMetadata

스트림 시작 시 코덱이나 해상도 등의 메타데이터를 전송

클라이언트가 직접 재생할 경우, 호환성을 위해 true권장

srcStream

스트리밍할 파일 또는 재생목록. 프리픽스를 반드시 지정해야 한다.

timeBetweenItems

재생목록을 재생할 시, 다음 콘텐츠 재생까지 대기 시간

이 형식에 맞춰 아래와 같이 streamDemoPublisherConfig의 Value를 지정할 수 있다.

appName=FileToLive,srcStream=m3u8:lst.m3u8,dstStream=MusicBox,random=false,timeBetweenItems=250

이 설정에 따라, 와우자는
① 재생목록 lst.m3u8 파일을 읽고, 재생목록에 기록된 순서에 따라
② 콘텐츠들을 250ms의 간격으로
③ 연속해서 반복 재생하는 스트림을(명시적으로 playlistRepeat를 선언하지 않았으나 자동 적용된다)
④ FileToLive라는 이름을 가진 어플리케이션에
⑤ MusicBox라는 이름으로 생성하게 된다.

Add 버튼을 클릭해 프로퍼티가 추가된 것을 확인한 후 Save 버튼을 클릭해 적용해 주고 와우자 서비스를 재시작해주면 streamDemoPublisherConfig 설정이 완료된다.

이 글에서는 다루지 않았지만 좀 더 다양한 조건을 지정하기 위한 프로퍼티들이 있다. 와우자 홈페이지에서 제공하는 문서를 참고하기 바란다.

Step 5 – 재생목록 파일의 생성과 업로드

재생목록으로 지정된 lst.m3u8 파일을 생성한다. 일반적인 텍스트 편집기를 이용해 다음과 같이 작성해 주면 된다. 본 필자는 위에서 언급한 3개의 MP3 오디오 파일을 스트리밍하기 위해 mp3: 프리픽스를 사용했다.

mp3:1.mp3
mp3:2.mp3
mp3:3.mp3

생성한 파일을 콘텐츠 디렉토리에 업로드해 준다.

Step 6 – 와우자 서비스 재시작

설정을 완료하고 모든 콘텐츠 파일이 업로드 되었음을 확인한다. 이상이 없다면 설정 변경을 적용하기 위해서 서비스를 재시작해 주어야 한다.

Step 7 – 어플리케이션 확인 (진실의 시간)

1. 와우자 웹 UI에 접속해 Applications 메뉴를 선택한 후, 좌측의 어플리케이션 목록 중 appName에서 지정한 어플리케이션을 선택한다.
2. Incoming Streams을 클릭해 스트림이 추가되었는지 확인한다.
3. 스트림의 비트레이트를 확인해 0이 아닌지 확인한다.

   

4. 최종적으로 VLC 등의 클라이언트를 이용해 스트림을 재생해 본다.