Playback Callback 사용하기

이 문서에서는 WECANDEO 플레이어 사용 시 설정 가능한 Playback Callback에 대해 설명합니다.

Playback Callback은 설정된 URL로 전송 주기마다 플레이어에서 사용자의 콘텐츠 시청 정보를 전송하는 기능입니다.

온라인 학습 서비스, LMS에서는 이 기능을 통해 사용자의 콘텐츠 진도를 체크하고 이어보기를 제공하는 데 활용할 수 있습니다.

사용하기 전에

• V4 버전의 비디오팩에서만 지원됩니다.
• 사전에 비디오팩 CMS에 설정 URL이 등록되어 있어야 합니다.
• 배포 패키지 단위로 설정할 수 있습니다.
• Play URL에서만 전송되며 Video URL을 사용하거나 타사 플레이어 사용 시 이용이 불가능합니다.

Callback 설정하기

• 비디오팩 CMS > 배포 > 배포 패키지 > 패키지 > 배포 설정 > Playback Callback 항목에서 콘텐츠 시청 정보를 전송 받을 URL을 입력 후 저장합니다.

• 전송 주기는 기본 10초로 설정되어 있으며 1초 이상의 값을 입력할 수 있습니다.

Callback Data

• vk : 비디오 키
• st : 비디오 정보 요청 시간
  • "st"는 콘텐츠 시청 정보가 처음 호출된 시점의 Unix Timestamp입니다.
• pt : 재생 시간
  • "pt"는 전체 누적 재생 시간을 의미합니다.
  • "pt"는 이미 재생한 구간에서의 시청도 포함합니다.
• lpt : 마지막 재생 위치
  • "lpt"는 재생 위치 중 가장 많이 진행된 지점을 의미합니다.

• 플레이어 iframe API에서 사용자 지정 아이디를 설정할 수 있습니다.
• 플레이어 iframe API에서 추가로 전송할 정보를 설정할 수 있습니다.

⚠️

사용자 지정 아이디의 설정은 오픈되어 있지 않으므로 담당 AM을 통해 문의 부탁드립니다.

기타 유의사항

• 플레이어가 재생을 시작하면 전송 주기에 따라 Callback 전송이 시작됩니다.
• "pt", "lpt"의 시간 단위는 초(s)입니다.
• "pt", "lpt"는 배속 기능을 사용한 경우 배속이 적용된 재생 시간도 포함합니다.
  e.g., 영상을 2배속으로 10분 동안 시청한 경우 pt와 lpt는 1200(초)이 됩니다.
• 일시정지 또는 시청 완료 시 Callback이 추가로 전송된 후 전송 중지됩니다.
• 플레이어의 재생이 종료(시청 완료)되면 Callback 정보는 초기화됩니다.
• Playback Callback 정보를 진도체크에 사용 시 위치 이동(Seek)를 허용하면 사용자의 실제 시청정보와 차이가 있을 수 있습니다.

📘

Playback Callback를 사용하는 방법 외에 플레이어 iframeAPI를 사용하여 진도 체크를 구현할 수도 있습니다. → 자세히보기