본문으로 건너뛰기

Player Callbacks

OnCompletionListener Interface​

com.kollus.sdk.media.MediaPlayer.OnCompletionListener

콘텐츠의 재생 완료 이벤트를 수신하는 인터페이스입니다.

Public Methods​

  • void onCompletion(MediaPlayer mp)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnCompletionListener.onCompletion(MediaPlayer mp)

재생이 완료된 시점에 호출됩니다.

  • 파라미터
    • mp: 재생이 완료된 플레이어 인스턴스

OnErrorListener Interface​

com.kollus.sdk.media.MediaPlayer.OnErrorListener

재생 중 발생하는 에러 정보를 수신하는 인터페이스입니다.

Public Methods​

  • boolean onError(MediaPlayer mp, int what, int extra)

Method Details​

boolean com.kollus.sdk.media.MediaPlayer.OnErrorListener.onError(MediaPlayer mp, int what, int extra)

재생 중 예기치 않은 에러가 발생했을 때 호출됩니다.

  • 파라미터
    • mp: 에러가 발생한 플레이어 인스턴스
    • what: 에러 코드 1
    • extra: 에러 코드 2
  • 반환값
    • true: 애플리케이션(UI) 영역에서 에러 처리 완료
    • false: 에러 처리 위임 (false 반환 시, SDK 내부에서 자동으로 onComplete를 호출하여 재생 세션을 종료함)

OnInfoListener Interface​

com.kollus.sdk.media.MediaPlayer.OnInfoListener

재생 중 발생하는 상태 정보(Info) 및 경고(Warning) 이벤트를 수신하는 인터페이스입니다.

Public Methods​

  • void onBufferingEnd(MediaPlayer mp)
  • void onBufferingStart(MediaPlayer mp)
  • void onChangedBandwidth(MediaPlayer mp, BandwidthItem item)
  • void onCodecInitFail(MediaPlayer mp, String componentName)
  • void onDetectBandwidthList(MediaPlayer mp, List<BandwidthItem> list)
  • void onDownloadRate(MediaPlayer mp, int downloadRate)
  • void onFrameDrop(MediaPlayer mp)
  • boolean onInfo(MediaPlayer mp, int what, int extra)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onBufferingEnd(MediaPlayer mp)

데이터 로딩이 완료되어 버퍼링 상태가 해제된 시점에 호출됩니다.

  • 파라미터
    • mp: 플레이어 인스턴스
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onBufferingStart(MediaPlayer mp)

네트워크 환경 등으로 인해 데이터 로딩(버퍼링)이 시작된 시점에 호출됩니다.

  • 파라미터
    • mp: 플레이어 인스턴스
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onChangedBandwidth(MediaPlayer mp, BandwidthItem item)

적응형 비트레이트(ABR) 콘텐츠 재생 중 비트레이트가 변경된 시점에 호출됩니다.

  • 파라미터
    • mp: 플레이어 인스턴스
    • item: 변경된 비트레이트 정보
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onCodecInitFail(MediaPlayer mp, String componentName)

하드웨어 코덱 초기화 실패 시 호출됩니다. (오디오 워터마크 포함 콘텐츠 또는 Android 4.3 Jelly Bean MR2 미만 디바이스 한정 발생)

  • 파라미터
    • mp: 플레이어 인스턴스
    • componentName: 초기화에 실패한 코덱 이름
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onDetectBandwidthList(MediaPlayer mp, List<BandwidthItem>  list)

적응형 비트레이트(ABR) 콘텐츠 재생 시, 서비스에서 지원 가능한 전체 대역폭 리스트가 감지되었을 때 호출됩니다.

  • 파라미터
    • mp: 플레이어 인스턴스
    • list: 전체 대역폭 정보 리스트
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onDownloadRate(MediaPlayer mp, int downloadRate)

콘텐츠 파일 다운로드 완료 시, 해당 파일의 평균 다운로드 전송 속도를 반환합니다.

  • 파라미터
    • mp: 플레이어 인스턴스
    • downloadRate: 평균 다운로드 속도 (bps)
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onFrameDrop(MediaPlayer mp)

비디오 프레임 드롭(Frame Drop) 현상 발생 시 호출됩니다. (오디오 워터마크 포함 콘텐츠 또는 Android 4.3 Jelly Bean MR2 미만 디바이스 한정 발생)

  • 파라미터
    • mp: 플레이어 인스턴스
boolean com.kollus.sdk.media.MediaPlayer.OnInfoListener.onInfo(MediaPlayer mp, int what, int extra)

플레이어의 상태 정보 또는 이벤트 발생 시 호출됩니다.

  • 파라미터
    • mp: 플레이어 인스턴스
    • what: 정보 유형
    • extra: 기타 데이터

OnPreparedListener Interface​

com.kollus.sdk.media.MediaPlayer.OnPreparedListener

재생 준비 완료 이벤트를 수신하는 인터페이스입니다.

Public Methods​

  • void onPrepared(MediaPlayer mp)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnPreparedListener.onPrepared(MediaPlayer mp)

재생 준비가 성공적으로 완료된 시점에 호출됩니다.

  • 파라미터
    • mp: 재생 준비가 완료된 플레이어 인스턴스

OnSeekCompleteListener Interface​

com.kollus.sdk.media.MediaPlayer.OnSeekCompleteListener

재생 위치 이동(Seek) 요청이 완료되었음을 수신하는 인터페이스입니다.

Public Methods​

  • void onSeekComplete(MediaPlayer mp)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnSeekCompleteListener.onSeekComplete(MediaPlayer mp)

재생 지점 변경 작업이 성공적으로 완료된 시점에 호출됩니다.

  • 파라미터
    • mp: 재생 위치 이동이 완료된 플레이어 인스턴스

OnVideoSizeChangedListener Interface​

com.kollus.sdk.media.MediaPlayer.OnVideoSizeChangedListener

콘텐츠의 초기 해상도 정보 확인 및 재생 중 해상도가 변경되었을 때 해당 정보를 수신하는 인터페이스입니다.

Public Methods​

  • void onVideoSizeChanged(MediaPlayer mp, int width, int height)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnVideoSizeChangedListener.onVideoSizeChanged(MediaPlayer mp, int width, int height)

비디오의 가로 및 세로 크기가 처음으로 식별되거나, 재생 중 해상도가 전환될 때 호출됩니다.

  • 파라미터
    • mp: 플레이어 인스턴스
    • width: 비디오의 가로 해상도
    • height: 비디오의 세로 해상도

KollusPlayerLMSListener Interface​

com.kollus.sdk.media.KollusPlayerLMSListener

시청자의 재생 진행률(진도율)을 학습 관리 시스템(LMS) 서버로 전송하고, 그에 대한 응답 결과를 수신하는 인터페이스입니다.

Public Methods​

  • void onLMS(String request, String response)

Method Details​

void com.kollus.sdk.media.KollusPlayerLMSListener.onLMS(String request, String response)

시청자의 재생 진행률(진도율) 데이터를 서버에 전송했을 때 발생하며, 전송한 메시지와 서버의 응답 메시지를 전달받습니다.

  • 파라미터
    • request: LMS 서버로 전송된 재생 진행률(진도율) 관련 데이터 메시지
    • response: 전송 결과에 대해 서버로부터 수신한 응답 메시지

KollusPlayerThumbnailListener Interface​

com.kollus.sdk.media.KollusPlayerThumbnailListener

콘텐츠 로드 시 비동기 스레드 방식으로 진행되는 섬네일 이미지의 다운로드 및 캐싱 상태를 수신하는 인터페이스입니다.

Public Methods​

  • void onCached(int index, int nErrorCode, String savePath)

Method Details​

void com.kollus.sdk.media.KollusPlayerThumbnailListener.onCached(int index, int nErrorCode, String savePath)

섬네일 다운로드가 스레드 방식으로 수행될 때, 각 콘텐츠별 다운로드 결과(성공 또는 실패)를 수신합니다.

  • 파라미터
    • index: 식별 번호 (KollusContent의 getUriIndex 값)
    • nErrorCode: 다운로드 결과 에러 코드 (0일 경우 성공)
    • savePath: 로컬 장치에 섬네일이 저장된 물리적 경로