Dev Console 플레이어로 재생 테스트하기

이 레슨의 위치

멀티DRM 퀵스타트의 세 번째 단계입니다. 패키징한 콘텐츠와 라이선스 토큰이 준비되었습니다. 이제 둘을 DoveRunner 테스트 플레이어에 넣고 실제 DRM 라이선스를 요청해 재생을 확인합니다. 재생이 안 될 때 로그를 읽는 방법도 다룹니다. 순서는 다음과 같습니다.

1. DASH URL과 라이선스 토큰 준비하기
2. Dev Console 웹 플레이어에 입력하기
3. 재생 로그 읽기

재생 시 라이선스를 받는 과정

재생 버튼을 누르면 다음 순서로 동작합니다.

1. 플레이어가 재생을 요청합니다.
2. 라이선스 토큰과 콘텐츠 정보를 DoveRunner 라이선스 서버로 보냅니다.
3. DoveRunner가 요청을 검증합니다.
4. 플레이어에 라이선스가 발급됩니다.
5. 재생이 시작됩니다.

이 라이선스 발급을 승인하는 것이 이전 레슨에서 만든 토큰입니다.

보호된 콘텐츠를 재생하는 방법

DRM 콘텐츠를 재생하는 방법은 세 가지입니다.

• HTML5 플레이어 샘플 코드: Shaka Player, dash.js 같은 웹 플레이어용입니다. Packager and Sample Downloads 페이지에서 내려받습니다.
• 네이티브 SDK: Android, iOS, 기타 OTT 플랫폼용이며, 같은 다운로드 페이지에서 받습니다.
• Dev Console 웹 플레이어: 코드 없이 빠르게 확인하는 도구입니다. 이 레슨에서 쓰는 방법입니다.

실제 서비스에서는 앞의 두 가지를 씁니다. 패키징과 토큰이 제대로 동작하는지 확인하는 용도라면 Dev Console 플레이어로 충분합니다.

1. 콘텐츠와 토큰 입력

Dev Console(devconsole.doverunner.com)의 DRM Tools > Tester에서 Web Player를 선택합니다(바로가기). 로그인은 필요 없습니다. 플레이어에는 브라우저가 보고하는 키 시스템과 보안 수준(예: L3의 com.widevine.alpha)이 표시됩니다. 다음 항목을 입력합니다.

항목	입력할 값
License URL	DoveRunner 라이선스 서버(https://drm-license.doverunner.com/ri/licenseManager.do)가 이미 채워져 있습니다. 그대로 둡니다
DASH URL	테스트 웹 서버에 올린 콘텐츠의 stream.mpd URL. 어디에 따로 등록할 필요는 없습니다
pallycon-customdata-v2	이전 레슨에서 발급한 라이선스 토큰

토큰을 만든 뒤 오래 지나지 않게 재생하세요. 기본 유효 시간은 10분입니다.

2. 재생하기

PLAY를 선택합니다. 플레이어가 라이선스를 요청하고, 문제가 없으면 영상이 시작됩니다.

검은 화면은 정상입니다. 컨트롤은 동작하고 재생 시간도 흐르는데 화면은 검게 보입니다. 오류가 아닙니다. 멀티DRM은 기본적으로 화면 캡처를 차단하므로 보호된 영상은 녹화나 스크린샷에 나타나지 않습니다. 이 플레이어를 녹화한 레슨 영상에서도 같은 현상이 나타납니다.

3. 로그 읽기

확인할 곳은 두 군데입니다.

플레이어 아래의 로그 패널. 두 가지 로그가 있습니다.

• DRM Log: 라이선스 요청과 결과. 요청이 실패하면 오류 코드와 메시지가 여기에 표시됩니다.
• Player Log: 플레이어의 처리 단계. 성공하면 Manifest parsed, Buffering - true, The video is set to Widevine. 같은 항목이 나타납니다.

DoveRunner Console의 Analytics. 전체 이력은 Content Security > Multi DRM > Analytics에서 봅니다. DRM Licenses 보기에서는 선택한 기간의 라이선스 요청을 차트로 보여 주고, 성공·실패 여부와 관계없이 모든 요청을 표로 나열합니다. 표에는 상태, 콘텐츠 ID, 사용자 ID, DRM 종류, 요청 일시, 디바이스 종류, 디바이스 모델, 플랫폼이 있으며 필터링과 내보내기가 가능합니다. Error, Piracy Guard 탭도 있습니다.

재생이 안 될 때

여기서 생기는 실패는 거의 다음 세 가지 때문입니다.

1. DRM 종류 불일치. 토큰의 DRM 종류가 브라우저와 맞아야 합니다. Chrome·Firefox는 Widevine, Edge는 PlayReady이며 대소문자를 구분합니다. 올바른 종류로 토큰을 새로 발급하세요.
2. 토큰 만료. 토큰은 기본 600초 후에 만료되며, 만료된 토큰으로는 라이선스를 발급받을 수 없습니다. 새 토큰을 발급하세요. 유효 시간은 Console의 Site Settings > Integration Settings에서 변경할 수 있습니다.
3. CORS 미허용. 콘텐츠와 플레이어가 서로 다른 도메인에 있다면, 콘텐츠를 호스팅하는 웹 서버가 교차 출처 접근을 허용해야 합니다. 해당 서버에서 CORS를 켠 뒤 새로고침하세요.

그래도 실패하면 DRM Log의 오류 코드를 복사해 라이선스 연동 가이드에서 찾아보세요.

이 코스에서 한 일

1. 영상을 DRM으로 보호된 MPEG-DASH로 패키징했습니다
2. 그 콘텐츠의 라이선스 토큰을 발급했습니다
3. 실제 라이선스를 요청해 재생했습니다

다음 단계

실제 서비스에 적용하려면 다음 가이드를 참고하세요.

• 콘텐츠 패키징 가이드: 다른 패키징 방식
• 라이선스 연동 가이드: 서버에서 토큰 생성하기
• 클라이언트 연동 가이드: 웹, 모바일, OTT에서 재생하기