Player Callbacks
OnBufferingUpdateListener Interface Deprecated
com.kollus.sdk.media.MediaPlayer.OnBufferingUpdateListener
버퍼링 상태 변경 데이터를 수신하는 인터페이스입니다.
Public Methods
- Deprecated
void onBufferingUpdate(MediaPlayer mp, int percent)
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 | MediaPlayer | 재생이 완료된 플레이어 인스턴스 |
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 | MediaPlayer | 에러가 발생한 플레이어 인스턴스 |
what | int | 에러 코드 1 |
extra | int | 에러 코드 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 | MediaPlayer | 플레이어 인스턴스 |
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onBufferingStart(MediaPlayer mp)
네트워크 환경 등으로 인해 데이터 로딩(버퍼링)이 시작된 시점에 호출됩니다.
| 파라미터 | 타입 | 설명 |
|---|---|---|
mp | MediaPlayer | 플레이어 인스턴스 |
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onChangedBandwidth(MediaPlayer mp, BandwidthItem item)
적응형 비트레이트(ABR) 콘텐츠 재생 중 비트레이트가 변경된 시점에 호출됩니다.
| 파라미터 | 타입 | 설명 |
|---|---|---|
mp | MediaPlayer | 플레이어 인스턴스 |
item | BandwidthItem | 변경된 비트레이트 정보 |
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onCodecInitFail(MediaPlayer mp, String componentName)
하드웨어 코덱 초기화 실패 시 호출됩니다. (오디오 워터마크 포함 콘텐츠 또는 Android 4.3 Jelly Bean MR2 미만 디바이스 한정 발생)
| 파라미터 | 타입 | 설명 |
|---|---|---|
mp | MediaPlayer | 플레이어 인스턴스 |
componentName | String | 초기화에 실패한 코덱 이름 |
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onDetectBandwidthList(MediaPlayer mp, List<BandwidthItem> list)
적응형 비트레이트(ABR) 콘텐츠 재생 시, 서비스에서 지원 가능한 전체 대역폭 리스트가 감지되었을 때 호출됩니다.
| 파라미터 | 타입 | 설명 |
|---|---|---|
mp | MediaPlayer | 플레이어 인스턴스 |
list | List<BandwidthItem> | 전체 대역폭 정보 리스트 |
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onDownloadRate(MediaPlayer mp, int downloadRate)
콘텐츠 파일 다운로드 완료 시, 해당 파일의 평균 다운로드 전송 속도를 반환합니다.
| 파라미터 | 타입 | 설명 |
|---|---|---|
mp | MediaPlayer | 플레이어 인스턴스 |
downloadRate | int | 평균 다운로드 속도 (bps) |
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onFrameDrop(MediaPlayer mp)
비디오 프레임 드롭(Frame Drop) 현상 발생 시 호출됩니다. (오디오 워터마크 포함 콘텐츠 또는 Android 4.3 Jelly Bean MR2 미만 디바이스 한정 발생)
| 파라미터 | 타입 | 설명 |
|---|---|---|
mp | MediaPlayer | 플레이어 인스턴스 |
boolean com.kollus.sdk.media.MediaPlayer.OnInfoListener.onInfo(MediaPlayer mp, int what, int extra)
플레이어의 상태 정보 또는 이벤트 발생 시 호출됩니다.
| 파라미터 | 타입 | 설명 |
|---|---|---|
mp | MediaPlayer | 플레이어 인스턴스 |
what | int | 정보 유형 |
extra | int | 기타 데이터 |
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 | MediaPlayer | 재생 준비가 완료된 플레이어 인스턴스 |
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 | MediaPlayer | 재생 위치 이동이 완료된 플레이어 인스턴스 |
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 | MediaPlayer | 플레이어 인스턴스 |
width | int | 비디오의 가로 해상도 |
height | int | 비디오의 세로 해상도 |
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 | String | LMS 서버로 전송된 재생 진행률(진도율) 관련 데이터 메시지 |
response | String | 전송 결과에 대해 서버로부터 수신한 응답 메시지 |
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 | int | 식별 번호 (KollusContent의 getUriIndex 값) |
nErrorCode | int | 다운로드 결과 에러 코드 (0일 경우 성공) |
savePath | String | 로컬 장치에 섬네일이 저장된 물리적 경로 |