파일 자동 반복 재생 24시간 라이브 스트림 생성 방법 : 와우자 서버 리스너 사용

Step 1 – 사전준비

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

어플리케이션

생성된 스트림을 송출하는데 사용할 와우자 라이브 어플리케이션

재생할 콘텐츠 파일

사용 가능한 파일 포맷 형식의콘텐츠 파일

정당한 사용 권한을 가지고 있어 저작권등에 문제가 없는 콘텐츠

복수의 콘텐츠 파일의 경우, 포멧이 동일해야 한다.

업로드 도구

WinSCP나 FTP 클라이언트와 같은 파일 업로드 도구

윈도우 환경에서는 USB등을 이용해 직접 디렉토리에 복사해 넣어도 된다.

콘텐츠 업로드 완료

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

윈도우 기본경로 :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

이 설정에 따라, 와우자는

1. 재생목록 lst.m3u8파일을 읽어, 그 안에 있는 콘텐츠들을
2. 재생목록에 기록된 순서에 따라,
3. 250mSec 의 간격으로
4. 연속해서 반복 재생하는 스트림을, (명시적으로 playlistRepeat를 선언하지 않았으나 자동 적용된다)
5. FileToLive라는 이름을 가진 어플리케이션에
6. MusicBox라는 이름으로 생성하게 된다.

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

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

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등의 클라이언트를 이용해 스트림을 재생해 본다.