콜백 설정
Kollus VOD는 업로드, 트랜스코딩, 콘텐츠 관리, 재생, 다운로드 등 다양한 작업 흐름에 대해 콜백(Callback) 기반 연동을 지원합니다.
콜백 기능을 사용하면 작업 완료 또는 이벤트 발생 시 지정된 URL로 HTTP 알림을 받아, 외부 시스템과 연동하거나 자동화를 구현할 수 있습니다.
Kollus VOD에서는 다음 두 가지 유형의 콜백을 제공합니다.
- 플랫폼 콜백: 콘솔 기반 작업 (업로드, 트랜스코딩, 콘텐츠 관리 등) 완료 시 호출
- 플레이어 콜백: 사용자 재생, 다운로드, 세션 이벤트 등 플레이어 실행 시 호출
콜백 흐름과 플러그인 옵션에 대한 자세한 설명은 개발 가이드를 참고해 주세요.
플랫폼 콜백
플랫폼 콜백은 콘솔에서 수행한 작업이 완료되었을 때, 지정한 서버 URL로 HTTP POST 요청을 보내 작업 결과를 알리는 방식입니다.
콜백 URL 설정 시에는 보안 및 안정성을 고려해야 합니다. 콜백 요청이 실패할 경우, 로그를 통해 원인을 확인할 수 있습니다.
콜백 유형과 설정 방법은 아래 표를 참고하세요.
| 콜백 유형 | 설명 및 설정 방법 |
|---|---|
| 업로드 콜백 | 콘텐츠 업로드 완료 시 알림을 전송합니다. Kollus VOD 콘솔의 [서비스 계정] > [콜백] 메뉴에서 [업로드 콜백 URL] 항목을 입력합니다. |
| 트랜스코딩 콜백 | 트랜스코딩 완료 시 알림을 전송합니다. Kollus VOD 콘솔의 [서비스 계정] > [콜백] 메뉴에서 [트랜스코딩 콜백 URL] 항목을 입력합니다. |
| 콘텐츠 업데이트 콜백 | 콘텐츠 추가, 삭제, 또는 채널 변경 시 알림을 전송합니다. Kollus VOD 콘솔의 [서비스 계정] > [콜백] 메뉴에서 [콘텐츠 업데이트 콜백 URL] 항목을 입력합니다. |
| 콘텐츠 채널 추가 콜백 | 채널에 콘텐츠 추가 시 알림을 전송합니다. Kollus VOD 콘솔의 [채널] 메뉴로 이동한 후, 콜백을 설정할 채널의 [⋮(더보기)] 버튼 > [콜백 설정]을 클릭합니다. 콜백 설정 창이 열리면 [콘텐츠 등록] 탭 > [콜백 사용] 체크박스 선택 > [콘텐츠 채널 추가 콜백 URL] 항목을 입력합니다. |
| 콘텐츠 채널 삭제 콜백 | 채널에서 콘텐츠 제거 시 알림을 전송합니다. Kollus VOD 콘솔의 [채널] 메뉴로 이동한 후, 콜백을 설정할 채널의 [⋮(더보기)] 버튼 > [콜백 설정]을 클릭합니다. 콜백 설정 창이 열리면 [콘텐츠 등록] 탭 > [콜백 사용] 체크박스 선택 > [콘텐츠 채널 삭제 콜백 URL] 항목을 입력합니다. |
업로드, 트랜스코딩, 콘텐츠 업데이트 콜백 설정 화면
콘텐츠 채널 추가, 콘텐츠 채널 삭제 콜백 설정 창
플레이어 콜백
플레이어 콜백은 사용자 기기(플레이어)에서 콘텐츠 재생, 다운로드, 세 션 이벤트 등이 발생했을 때, 지정된 콜백 URL로 이벤트 정보를 전송하는 방식입니다. Kollus VOD 콘솔에서 채널 단위로 콜백 URL을 설정할 수 있습니다.
콜백의 주요 종류는 다음과 같습니다.
- 플레이 콜백: 콘텐츠 재생 요청 시 호출
- DRM 다운로드 콜백: 콘텐츠 다운로드 요청 시 호출
- LMS 콜백: 재생 중 구간별 진행 정보를 주기적으로 전송
- 다음 회차 콜백: 연속 재생 시 다음 회차 시작 트리거
플레이 콜백
플레이 콜백은 최종 사용자(End User)가 콘텐츠 재생을 요청할 때 알림을 전송합니다.
플레이 콜백은 암호화(Kollus DRM) 콘텐츠 재생, 중복 재생 차단, 녹화/캡처 차단 등의 보안 기능을 이용할 수 있는 HTML5 Player for PC 및 Kollus App Player에서만 지원합니다.
플레이 콜백을 설정하려면 다음 절차를 따르세요.
- Kollus VOD 콘솔의 [채널] 메뉴로 이동합니다.
- 콜백을 설정할 채널의 [⋮(더보기)] 버튼 > [콜백 설정]을 클릭합니다.
- 콜백 설정 창이 열리면 [플레이/다운로드] 탭 > [플레이 콜백 URL] 항목을 입력합니다.
⚠️주의입력한 콜백 URL의 포트가 방화벽 설정에 의해 허용되어 있는지 반드시 확인해야 합니다.
- 입력을 완료한 후, [저장] 버튼을 클릭합니다.
DRM 다운로드 콜백
DRM 다운로드 콜백은 최종 사용자(End User)가 콘텐츠 다운로드를 요청할 때 알림을 전송합니다.
PC 다운로드와 모바일 DRM 다운로드 콜백 URL을 각각 설정할 수 있습니다.
DRM 다운로드 콜백을 설정하려면 다음 절차를 따르세요.
- Kollus VOD 콘솔의 [채널] 메뉴로 이동합니다.
- 콜백을 설정할 채널의 [⋮(더보기)] 버튼 > [콜백 설정]을 클릭합니다.
- 콜백 설정 창이 열리면 [플레이/다운로드] 탭으로 이동합니다.
- DRM 다운로드 콜백을 사용할 항목을 선택한 뒤, 콜백 URL을 입력합니다.
⚠️주의입력한 콜백 URL의 포트가 방화벽 설정에 의해 허용되어 있는지 반드시 확인해야 합니다.
- 입력을 완료한 후, [저장] 버튼을 클릭합니다.
LMS 콜백
LMS(Learning Management System, 학습 관리 시스템) 콜백은 콘텐츠 재생 중 일정 간격으로 현재 재생 상태와 구간 정보를 서버로 전송하는 기능입니다. 학습 관리(LMS), 진행률 추적, 수강 시간 기록 등에 활용할 수 있습니다.
LMS 콜백을 설정하려면 다음 절차를 따르세요.
- Kollus VOD 콘솔의 [채널] 메뉴로 이동합니다.
- 콜백을 설정할 채널의 [⋮(더보기)] 버튼 > [콜백 설정]을 클릭합니다.
- 콜백 설정 창이 열리면 [LMS] 탭으로 이동합니다.
- 설정 가능한 항목은 다음과 같습니다.
항목 설명 블록 수 콘텐츠 재생 구간을 분할하는 블록의 수입니다.
예: 300초 영상의 블록 수를 10으로 설정하면, 각 블록의 길이는 30초가 됩니다.전송 주기 정보 전송 주기입니다.(단위: 초) 블록 정보 포함 블록 수 정보를 포함하여 전송합니다. 세션 정보 포함 블록 정보, 블록 시작, 재생 시간 등의 세션 정보를 포함하여 전송합니다. 콜백 URL LMS 콜백을 받을 서버 URL을 입력합니다. 플러그인 옵션 LMS 콜백에 포함할 정보를 설정합니다.(파라미터 키 수정 가능)
자세한 설명은 LMS 콜백 문서를 참고하세요.LMS 콜백 데이터 위 항목들을 설정하면 자동으로 작성됩니다. 
- 설정을 완료한 후, [저장] 버튼을 클릭합니다.
다음 회차 콜백
다음 회차 기능은 시리즈 콘텐츠에서 현재 영상이 끝나기 전 [다음 회] 버튼을 노출하여 바로 다음 영상을 시청할 수 있게 해줍니다.
다음 회차 기능을 사용하려면 다음 설정을 완료해야 합니다.
- Kollus VOD 콘솔에서 다음 회차 콜백 URL을 설정합니다.
- 플레이어 호출을 위한 JWT 생성 시 페이로드 항목에
"next_episode": true를 포함해야 합니다.
다음 회차 콜백을 설정하려면 다음 절차를 따르세요.
- Kollus VOD 콘솔의 [채널] 메뉴로 이동합니다.
- 콜백을 설정할 채널의 [⋮(더보기)] 버튼 > [콜백 설정]을 클릭합니다.
- 콜백 설정 창이 열리면 [LMS] 탭으로 이동합니다.
- 설정 가능한 항목은 다음과 같습니다.
항목 설명 다음 회차 사용 다음 회차 사용 여부를 설정합니다. 영상 종료 N초 전 [다음 회] 버튼 표시 [다음 회] 버튼을 노출할 시점을 설정합니다. - 1 이상 600 이하의 정수만 입력 가능합니다.
- 영상 길이를 초과하는 시 간으로 설정 시, ‘다음 회’ 버튼은 영상 처음부터 노출됩니다.
콜백 URL 다음 회차 콜백을 받을 서버 URL을 입력합니다. 플러그인 옵션 다음 회차 콜백에 포함할 정보를 설정합니다.(파라미터 키 수정 가능)
자세한 설명은 다음 회차 콜백 문서를 참고하세요.다음 회차 콜백 데이터 위 항목들을 설정하면 자동으로 작성됩니다. 
- 설정을 완료한 후, [저장] 버튼을 클릭합니다.
- 플레이어 호출을 위한 JWT 생성 시 페이로드 항목에
"next_episode": true를 포함합니다.
JWT 생성에 대한 자세한 설명은 암호화 콘텐츠 재생 URL 생성 (JWT) - Kollus DRM 문서를 참고하세요.