콜백 기능
Last updated
Last updated
이 페이지에서는 Kollus VOD의 콜백 기능에 대해 안내합니다.
콜백Kollus VOD는 고객의 동영상 서비스에 다양한 비즈니스 로직을 구현할 수 있도록 콜백(Callback) 기반 서비스 연동을 지원합니다. 콜백 기능은 고객에게 작업 진행 성공 또는 실패 시 고객의 웹 URL로 작업 진행 상황 알림을 전송하여 편의성을 제공합니다. 또한 콜백 전송 서버가 응답하지 않는다면, 로그를 확인하여 실패 원인을 파악하여 서비스를 지원합니다.
모든 콜백은 고객사가 설정한 Web URL의 POST 방식을 사용하여 전달합니다. 콜백 알림은 다음과 같은 이벤트가 발생했을 때, 설정된 페이지로 알림이 전달됩니다.
업로드 완료: 콘텐츠 업로드가 완료된 경우 전달되는 알림입니다.
트랜스코딩 완료: 업로드한 콘텐츠의 트랜스코딩이 완료된 경우 전달되며 콘텐츠를 채널에 등록할 수 있는 상태에 대한 알림입니다.
채널에 콘텐츠 추가/삭제 완료: 채널에 콘텐츠가 추가 또는 삭제되었을 때 전달되며, 각 채널에 설정된 배포 정책을 적용하여 콘텐츠를 서비스할 수 있는 상태에 대한 알림입니다.
Kollus Player에서의 콘텐츠 플레이 요청(플레이 콜백): Kollus DRM을 사용하는 콘텐츠에 대한 플레이 요청 이벤트가 발생했을 때 전달되는 알림입니다. 알림에 포함된 정보를 활용하여 재생 허용 여부를 결정할 수 있습니다. 재생 허용 여부는 Post Request에 대한 Response를 통해 제어할 수 있습니다.
Kollus DRM 콘텐츠 다운로드 및 플레이 요청(DRM 다운로드 콜백): 사용자 기기에 콘텐츠를 다운로드한 후에 플레이 요청 이벤트가 발생했을 때 전달되는 알림입니다. 알림에 포함된 정보를 활용하여 재생 허용 여부와 다양한 DRM 정책을 설정할 수 있습니다. DRM 정책에 대한 관리는 Post Request에 대한 Response를 통해 제어할 수 있습니다.
콘텐츠에 대한 플레이 정보 전송(LMS 콜백): 일정한 주기마다 사용자의 콘텐츠 재생 관련 정보를 지정된 서버로 전송할 수 있습니다.
Kollus VOD의 콜백은 플랫폼에서 전달하는 플랫폼 콜백과 플레이어에서 전달하는 플레이어 콜백으로 구분됩니다. 플랫폼 콜백은 Kollus VOD 웹 콘솔에서 사용자 인증 후 요청한 작업을 완료했을 경우 알림을 전송합니다. 플랫폼 콜백은 업로드 콜백, 트랜스코딩 콜백, 채널 콜백을 포함합니다.
콘텐츠를 구분하는 고유한 키인 업로드 파일 키를 이용하여 업로드 완료 시 콜백 알림을 전송합니다.
업로드 파일 키를 이용하여 트랜스코딩 완료 시 콜백 알림을 전송합니다.
채널에 콘텐츠가 추가, 삭제 및 재생이 되면 콜백 알림을 전송합니다.
플레이어 콜백은 플레이어에서 이용한 콘텐츠 정보를 콜백 URL로 지정한 주소에 전달하는 기능입니다. 플레이어 콜백은 Kollus Player에서 지정한 이벤트가 발생했을 때 관련 정보를 지정된 서버로 전송합니다. 플레이어 콜백은 플레이 콜백, DRM 다운로드 콜백, LMS 콜백 등을 포함합니다.
플레이 콜백을 사용하기 위해서는 관리자 권한으로 로그인한 계정으로 CMS의 관리의 채널 속성에서 콜백을 응답받을 URL을 등록해야 합니다. 플레이 콜백 URL이 설정되지 않은 채널은 콜백 응답과 관계없이 요청 시 콘텐츠를 재생합니다.
참고
플레이 콜백은 암호화(Kollus DRM) 콘텐츠 재생, 중복 재생 차단, 캡처 차단 등의 보안 기능을 이용할 수 있는 보안 플레이어에서만 지원합니다.
Kollus DRM이 적용된 콘텐츠 중 사용자 기기에 다운로드된 영상에 대한 라이선스 관리를 위해 사용하는 콜백입니다. 콘텐츠의 재생 제한 횟수, 콘텐츠 만료 기간, 콘텐츠 재생 시간 정보를 설정하여 콘텐츠의 재생을 제어하고, 요청의 결과를 확인할 수 있습니다. DRM 다운로드 콜백은 콘텐츠 다운로드 전, 다운로드 후, 재생 요청 단계에서 사용자, 디바이스, 미디어 콘텐츠 키 등을 확인합니다. DRM 다운로드 콜백을 사용하기 위해서는 채널에 DRM 다운로드 콜백 URL을 설정해야 합니다. DRM 다운로드 콜백 URL을 설정하면 콘텐츠를 다운로드하는 시점에 해당 URL을 호출하여 반환된 값으로 DRM 다운로드 콜백을 수행합니다.
플레이어에서 사용자가 이용한 시청 정보를 LMS 콜백 URL에 전달하는 기능입니다. 채널에서 LMS 콜백을 설정한 후에 동영상 재생 정보를 설정한 서버로 전달받을 수 있습니다. LMS 콜백은 주기적으로 동영상 콘텐츠 재생 정보를 전달하고 일시정지, 정지 등의 플레이어 이벤트가 발생할 때에도 관련 이벤트 정보를 전송합니다.
'다음 회차'는 사용자가 연속된 시리즈 콘텐츠를 볼 때 일일이 다음 편을 찾아가지 않고, 보던 콘텐츠 끝부분에 노출되는 ‘다음 회’ 버튼을 눌러 바로 다음 콘텐츠를 볼 수 있는 서비스입니다. 이 서비스를 위해서는 다음 회 영상에 대한 정보를 서버로 전달해야 합니다.
