# 콜백 설정

이 페이지에서는 Kollus VOD 콘솔에서 채널 관련 콜백 설정을 하는 방법에 대해 안내합니다.



> ### **콜백** <a href="#id" id="id"></a>
>
> Kollus VOD는 고객사에게 작업 진행 상황을 전달하기 위해 고객의 웹 URL로 콜백(callback) 알림을 제공하며, 콘텐츠 전송 채널마다 콜백을 각각 설정할 수 있습니다. Kollus VOD 콘솔의 채널 리스트 또는 카드 리스트에서 **더보기 > 콜백 설정**을 클릭하면 설정한 콜백 내용을 확인할 수 있습니다.



### **콘텐츠 등록** <a href="#id-.1" id="id-.1"></a>

채널에 콘텐츠가 추가 또는 삭제될 때마다 콜백을 받고 싶은 경우 이용합니다. '콜백 사용' 체크박스에 체크한 다음, 콜백 URL를 입력하면 됩니다.

<figure><img src="https://92012944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F07xE4g9511BtbCTnY4D4%2Fuploads%2FOsZRjJ3rCg4YnDRupFQi%2Fimage.png?alt=media&#x26;token=f973d352-807c-4c5b-90fb-a05623d9d784" alt="" width="295"><figcaption><p>콜백 설정 > 콘텐츠 등록</p></figcaption></figure>

### **플레이/다운로드** <a href="#id" id="id"></a>

플레이 콜백은 Kollus Player로부터 채널 콘텐츠의 재생 요청이 있을 때 받는 알림입니다. 이용을 원할 경우, 플레이 콜백 URL을 입력하면 됩니다. 그리고 URL 포트가 방화벽 정책에 허용되어 있는지 확인해 주세요.

DRM 다운로드 콜백은 Kollus Player로부터 채널 콘텐츠의 다운로드 또는 다운로드 콘텐츠의 재생 요청이 있을 때 받는 알림입니다. 이용을 원할 경우, PC 다운로드 사용과 모바일 다운로드 사용에 각각 체크한 후 다운로드 DRM 콜백 URL을 입력하면 됩니다. 그리고 URL 포트가 방화벽 정책에 허용되어 있는지 확인해 주세요.

<figure><img src="https://92012944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F07xE4g9511BtbCTnY4D4%2Fuploads%2FhY1aPCo8i0WGvW7PzopC%2Fimage.png?alt=media&#x26;token=2b1110a0-64c5-4e89-90bd-40147cd70e0e" alt="" width="298"><figcaption><p>콜백 설정 > 플레이/다운로드</p></figcaption></figure>

### **LMS** <a href="#id-lms" id="id-lms"></a>

LMS 콜백은 Kollus Player 사용자가 이용한 콘텐츠 정보를 전달합니다. 플레이어에서 일시정지 또는 정지를 한 경우에도 콜백이 전달됩니다. LMS 콜백은 다음의 항목을 설정할 수 있습니다.

* 블록 수: 콘텐츠 재생 구간을 나누는 블록의 수입니다. 10으로 설정하면 콘텐츠의 길이가 300초의 경우 각 블록은 30초로 구성됩니다.
* 전송 주기: 지정한 전송 주기마다 호출됩니다. 전송 주기는 초 단위를 지원합니다.
* 블록 정보 포함: 활성화할 경우 block\_info 전송 항목에 블록 개수 정보를 포함시킵니다.
* 세션 정보 포함: 활성화할 경우 block\_info 전송 항목에 세션 정보(블록 정보, 블록 시작, 재생 시간 등)를 포함시킵니다.
* 콜백 URL: LMS 콜백을 전달받을 URL을 입력합니다.
* 플러그인 옵션: 재생 정보를 전달하기 위한 옵션은 JSON 형태의 Array로 전달됩니다. LMS 콜백에 포함할 옵션을 선택할 수 있으며, 파라미터 키 값도 수정할 수 있습니다. 구체적인 옵션 항목은 [개발 가이드](https://catenoid-support.atlassian.net/wiki/spaces/SUP/pages/3311166/LMS+Callback)에서 확인할 수 있습니다.
* LMS 콜백 데이터: 콜백 URL 입력과 플러그인 옵션 선택을 마치면 자동으로 콜백 데이터가 작성됩니다.

<figure><img src="https://92012944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F07xE4g9511BtbCTnY4D4%2Fuploads%2FZQ9Ry06qv19Jsw0uNNli%2Fimage.png?alt=media&#x26;token=53dffd44-5ca4-49c9-a2cb-257477997a1f" alt="" width="298"><figcaption><p>콜백 설정 > LMS</p></figcaption></figure>

### **다음 회차** <a href="#id-lms" id="id-lms"></a>

다음 회차란 사용자가 연속된 시리즈 동영상을 볼 때 일일이 다음 편을 찾아가지 않고, 보던 영상 끝 부분에 뜨는 ‘다음 회’ 버튼을 눌러 바로 다음 영상을 볼 수 있는 서비스입니다. 이 서비스를 위해서는 다음 회차 콜백 설정과 JWT(JSON Web Token) 등이 준비되어야 합니다.

* 다음 회차 사용: 다음 회차 사용 여부를 체크합니다. (기본 값은 off)
* 영상 종료 N초 전 ‘다음 회’ 버튼 표시: 영상 종료까지 입력한 숫자의 시간이 남았을 때 ‘다음 회’ 버튼이 표시됩니다.
  * 텍스트 박스에는 600이하의 정수만 입력 가능합니다. (기본 값은 10)
  * 플레이어 영상 시간보다 더 긴 시간으로 설정 시, ‘다음 회’ 버튼은 영상 처음부터 노출됩니다.
* 콜백 URL: 다음 회차 콜백을 전달받을 URL을 입력합니다.
* 플러그인 옵션: 다음 회차 실행 관련 정보를 전달하기 위한 옵션은 JSON 형태의 Array로 전달됩니다. 다음 회차 콜백에 포함할 옵션을 선택할 수 있습니다. 구체적인 옵션 항목은 [개발 가이드](https://catenoid-support.atlassian.net/wiki/spaces/SUP/pages/237305858/Callback)에서 확인할 수 있습니다.
* 다음 회차 콜백 데이터: 콜백 URL 입력과 플러그인 옵션 선택을 마치면 자동으로 콜백 데이터가 작성됩니다.

<figure><img src="https://92012944-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F07xE4g9511BtbCTnY4D4%2Fuploads%2Fmr8H64P83nCMjEwbTWcD%2Fimage.png?alt=media&#x26;token=b93959a5-356a-41f9-bff5-c04fe7936a3c" alt="" width="323"><figcaption><p>콜백 설정 > 다음 회차</p></figcaption></figure>

