콜백 연동
Kollus VOD는 워크플로우 전반에 걸쳐 시스템 간 자동화를 위한 콜백(Callback) 연동을 지원합니다. 특정 이벤트 발생 시 지정된 URL로 HTTP POST 요청을 전송하여 외부 시스템(LMS, CMS 등)과 실시간으로 데이터를 동기화할 수 있습니다.
콜백 유형
Kollus VOD에서 제공하는 콜백 유형은 다음과 같습니다.
- 플랫폼 콜백: 관리자 콘솔 작업(업로드, 트랜스코딩, 콘텐츠 관리) 완료 시 호출
- 플레이어 콜백: 시청자 동작(재생, 다운로드, 학습 진도, 다음 회차 전환) 발생 시 호출
ℹ️개발자 가이드
콜백 페이로드 구조 및 파라미터 상세 사양은 개발 가이드를 참고하세요.
플랫폼 콜백
플랫폼 콜백(Platform Callback)은 콘솔에서 수행한 작업 결과를 서버로 전송합니다.
⚠️네트워크 설정
입력한 콜백 서버 URL의 포트가 Kollus 서버의 요청을 허용하도록 방화벽이 설정되어 있는지 반드시 확인해야 합니다.
| 콜백 유형 | 설명 및 설정 경로 |
|---|---|
| 업로드 콜백 | 콘텐츠 업로드 완료 시 알림 전송
|
| 트랜스코딩 콜백 | 트랜스코딩 완료 시 알림 전송
|
| 콘텐츠 업데이트 콜백 | 메타데이터 수정, 콘텐츠 삭제 또는 채널 이동 시 호출
|
| 콘텐츠 채널 추가 콜백 | 채널에 콘텐츠가 등록될 때 호출
|
| 콘텐츠 채널 삭제 콜백 | 채널에서 콘텐츠가 제거될 때 호출
|
업로드, 트랜스코딩, 콘텐츠 업데이트 콜백 설정 화면
콘텐츠 채널 추가, 콘텐츠 채널 삭제 콜백 설정 창
플레이어 콜백
플레이어 콜백(Player Callback)은 시청 환경에서 발생하는 이벤트를 실시간으로 전송하며, 채널 단위로 독립적인 설정이 가능합니다.
⚠️네트워크 설정
입력한 콜백 서버 URL의 포트가 Kollus 서버의 요청을 허용하도록 방화벽이 설정되어 있는지 반드시 확인해야 합니다.
플레이 콜백
시청자가 콘텐츠 재생을 시도할 때 호출됩니다.
- 설정 경로:
Kollus VOD 콘솔 > [채널] > 좌측 채널 목록 또는 채널 카드 [더보기(⋮)] > [콜백 설정] > [플레이/다운로드] 탭 > [플레이 콜백] - 주의 사항: 플레이 콜백은 Kollus 보안 플레이어 환경에서만 작동합니다.
DRM 다운로드 콜백
시청자가 오프라인 시청을 위해 다운로드를 요청할 때 호출됩니다.
- 설정 경로:
Kollus VOD 콘솔 > [채널] > 좌측 채널 목록 또는 채널 카드 [더보기(⋮)] > [콜백 설정] > [플레이/다운로드] 탭 > [DRM 다운로드 콜백] - 주의 사항: DRM 다운로드 콜백은 Kollus 보안 플레이어 환경에서만 작동합니다.
LMS 콜백
시청자의 진도율(Progress)을 정밀하게 측정하기 위해 주기적으로 재생 정보를 전송합니다.
- 설정 경로:
Kollus VOD 콘솔 > [채널] > 좌측 채널 목록 또는 채널 카드 [더보기(⋮)] > [콜백 설정] > [LMS] 탭 - 설정 항목
항목 설명 블록 수 영상을 분할하는 논리적 구간 수
예: 300초 영상의 블록 수를 10으로 설정하면, 각 블록의 길이는 30초가 됩니다.전송 주기 서버로 데이터를 전송할 시간 간격 (초) 블록 정보 포함 블록 정보 포함 여부 세션 정보 포함 세션 정보(시작 시점, 재생 시간 등) 포함 여부 콜백 URL LMS 데이터를 수신할 고객사 측 서버 주소 플러그인 옵션 콜백에 포함할 정보 (파라미터 키 수정 가능, 참고: LMS 콜백 - 콜백 설정 정보) LMS 콜백 데이터 위 항목 설정 시 자동 작성
다음 회차 콜백
시리즈 콘텐츠 재생 중 다음 에피소드 정보를 미리 호출하여 끊김 없는 시청 환경을 구축합니다.
- 필수 조건
- 콘솔 설정:
Kollus VOD 콘솔 > [채널] > 좌측 채널 목록 또는 채널 카드 [더보기(⋮)] > [콜백 설정] > [다음 회차] 탭에서[다음 회]버튼 노출 시점과 및 콜백 URL 등록 - 토큰 설정: 플레이어 호출 토큰(JWT)에
"next_episode": true파라미터 포함 (참고: Kollus DRM 전용 JWT 규격)
- 콘솔 설정:
- 콘솔 설정 항목
항목 설명 다음 회차 사용 연속 재생 기능 활성화 여부 영상 종료 N초 전 [다음 회]버튼 표시영상 종료 전 [다음 회]버튼을 표시할 시간 (영상 길이보다 길게 설정 시 영상 처음부터 버튼 노출)콜백 URL 콜백을 수신할 고객사 측 서버 주소 플러그인 옵션 콜백에 포함할 정보 (파라미터 키 수정 가능, 참고: 다음 회차 콜백 - 콜백 설정 정보) 다음 회차 콜백 데이터 위 항목 설정 시 자동 작성
