MediaPlayer

MediaPlayer Class

com.kollus.sdk.media.MediaPlayer

콘텐츠 재생, 화면 출력 제어, 자막 관리 및 각종 멀티미디어 이벤트를 처리하는 SDK의 핵심 재생 엔진 클래스입니다.

Classes & Interfaces

interface APP_STATUS
enum EXTERNAL_DISPLAY_MODE
enum MediaRouteState
Deprecated interface OnBufferingUpdateListener
interface OnCompletionListener
interface OnErrorListener
interface OnExternalDisplayDetectListener
interface OnInfoListener
interface OnMediaRouteInfoListener
interface OnPreparedListener
interface OnSeekCompleteListener
interface OnTimedTextDetectListener
interface OnTimedTextListener
interface OnVideoSizeChangedListener
class TMCMReceiver
class TrackInfo

Public Methods

MediaPlayer(Context context, KollusStorage storage, int port)
void addTimedTextSource(boolean bSubTimedText, String path) throws IOException, IllegalArgumentException, IllegalStateException, RuntimeException
void addTimedTextSource(Context context, boolean bSubTimedText, Uri uri) throws IOException, IllegalArgumentException, IllegalStateException
void deleteKollusBookmark(int position) throws IllegalStateException
void deselectTrack(boolean bSubTimedText, int index) throws IllegalStateException
void destroyDisplay()
int getBandwidth()
int getCachedDuration()
int getCurrentPosition()
int getDownloadRate()
int getDuration()
String getErrorString(int errorCode)
boolean getKollusContent(KollusContent content) throws IllegalStateException
int getPlayAt()
String getPlayerName()
MediaPlayerBase.TrackInfo[] getTrackInfo() throws IllegalStateException
String getVersion()
String getVideoCodecName()
int getVideoHeight()
int getVideoWidth()
boolean isAiPlaybackRateEnabled()
boolean isLooping()
boolean isPlaying()
void pause() throws IllegalStateException
void prepareAsync()
void release()
void seekTo(int msec) throws IllegalStateException
void seekToExact(int msec) throws IllegalStateException
void selectTrack(boolean bSubTimedText, int index) throws IllegalStateException
void setAiPlaybackRateEnable(boolean enable)
void setAppStatus(@APP_STATUS int status)
void setAudioDelay(int timeMs)
void setBandwidth(int bandwidth)
void setBandwidthName(String bandwidthName)
boolean setBufferingRatio(int ratio)
void setCaptureDetectLister(CaptureDetectLister listener)
void setDataSourceByKey(String mediaContentKey, String extraDrmParam)
void setDataSourceByUrl(String path, String extraDrmParam)
void setDisplay(SurfaceHolder sh)
void setEmulatorCheckerListener(EmulatorCheckerListener listener)
void setForensicWatermarkView(ForensicWatermarkView view)
void setInitialBandwidth(int bandwidth)
void setKollusPlayerBookmarkListener(KollusPlayerBookmarkListener listener)
void setKollusPlayerLMSListener(KollusPlayerLMSListener listener)
void setLastOffsetTime(int lastOffsetTimeMs)
void setLmsOffDownloadContent(boolean bOn)
void setLooping(boolean looping)
void setMinDurationForQualityIncreaseMs(int msec)
void setMute(boolean mute)
boolean setNetworkTimeout(int timeout)
void setNotifyLastReport(boolean bOn)
Deprecated void setOnBufferingUpdateListener(OnBufferingUpdateListener listener)
void setOnCompletionListener(OnCompletionListener listener)
void setOnErrorListener(OnErrorListener listener)
void setOnExternalDisplayDetectListener(OnExternalDisplayDetectListener listener)
void setOnInfoListener(OnInfoListener listener)
void setOnMediaRouteInfoListener(OnMediaRouteInfoListener listener)
void setOnPreparedListener(OnPreparedListener listener)
void setOnSeekCompleteListener(OnSeekCompleteListener listener)
void setOnTimedTextDetectListener(OnTimedTextDetectListener listener)
void setOnTimedTextListener(OnTimedTextListener listener)
void setOnVideoSizeChangedListener(OnVideoSizeChangedListener listener)
boolean setPlayingRate(float playing_rate) throws IllegalStateException
void setRemoteMediaRouteInfo(String castNameSpace)
void setScreenOnWhilePlaying(boolean screenOn)
void setSurface(Surface surface)
void setVideoRending(boolean bRendering)
void skip()
void start() throws IllegalStateException
void stop() throws IllegalStateException
boolean supportPlaybackrateControl()
void updateKollusBookmark(int position, String label) throws IllegalStateException

Static Public Properties

static final String VERSION = "2.0.19_r3"
static final int MEDIA_ERROR_UNKNOWN = 1
static final int APP_STATUS_BACKGROUND = 1
static final int APP_STATUS_FOREGROUND = 2
static final int MEDIA_INFO_FRAME_RATE = 7
static final int MEDIA_ERROR_NOT_VALID_FOR_PROGRESSIVE_PLAYBACK = 200
static final int QUICK = 1
static final int EXACT = 2
static final String CAST_NAME_SPACE = "urn:x-cast:com.kollus.cast"
static final String CAST_APP_ID = "E956F6B0"

Protected Methods

void setKollusStorage(KollusStorage storage)

Constructors & Destructors

com.kollus.sdk.media.MediaPlayer.MediaPlayer(Context context, KollusStorage storage, int port)

플레이어 인스턴스를 생성합니다.

파라미터	타입	설명
`context`	`Context`	`Context` 인스턴스
`storage`	`KollusStorage`	`KollusStorage` 인스턴스
`port`	`int`	내장 플레이어 통신에 필요한 서버 포트 번호

Method Details

void com.kollus.sdk.media.MediaPlayer.addTimedTextSource(boolean bSubTimedText, String path) throws IOException, IllegalArgumentException, IllegalStateException, RuntimeException

HTTP URL 경로를 통해 자막을 설정합니다.

파라미터	타입	설명
`bSubTimedText`	`boolean`	서브 자막 유무
`path`	`String`	자막 파일의 HTTP URL 경로

참고: OnTimedTextDetectListener

void com.kollus.sdk.media.MediaPlayer.addTimedTextSource(Context context, boolean bSubTimedText, Uri uri) throws IOException, IllegalArgumentException, IllegalStateException

Android URI를 통해 자막을 설정합니다.

파라미터	타입	설명
`context`	`Context`	애플리케이션 컨텍스트
`bSubTimedText`	`boolean`	서브 자막 유무
`uri`	`Uri`	자막 파일의 URI 경로

void com.kollus.sdk.media.MediaPlayer.deleteKollusBookmark(int position) throws IllegalStateException

특정 위치의 북마크 정보를 삭제합니다. 삭제 성공 여부는 onBookmarkInfoDeleted 콜백을 통해 리턴됩니다.

파라미터	타입	설명
`position`	`int`	삭제할 북마크의 위치 (ms)

void com.kollus.sdk.media.MediaPlayer.deselectTrack(boolean bSubTimedText, int index) throws IllegalStateException

selectTrack 메서드를 통해 선택된 특정 미디어 트랙을 해제합니다.

파라미터	타입	설명
`bSubTimedText`	`boolean`	서브 자막 트랙 여부
`index`	`int`	해제 대상 트랙의 인덱스

void com.kollus.sdk.media.MediaPlayer.destroyDisplay()

비디오 출력 화면(Surface 또는 SurfaceHolder)의 Destroy 시점에 호출하여 자원을 정리합니다.

int com.kollus.sdk.media.MediaPlayer.getBandwidth()

MPEG-DASH 환경에서 ABR(Adaptive Bitrate) 재생 시 현재 다운로드 중인 대역폭 정보를 조회합니다.

반환값: 대역폭 (현재 다운로드하고 있는 Bandwidth 값)

int com.kollus.sdk.media.MediaPlayer.getCachedDuration()

스트리밍 재생 시 현재 버퍼에 캐싱된 영상의 길이를 조회합니다.

반환값: 캐싱된 영상 길이 (ms)

int com.kollus.sdk.media.MediaPlayer.getCurrentPosition()

현재 재생 위치를 조회합니다.

반환값: 현재 재생 위치 (ms)

int com.kollus.sdk.media.MediaPlayer.getDownloadRate()

MPEG-DASH 재생 환경에서 현재 데이터 다운로드 속도를 조회합니다.

반환값: 다운로드 속도

int com.kollus.sdk.media.MediaPlayer.getDuration()

현재 재생 중인 콘텐츠의 전체 길이를 조회합니다.

반환값: 콘텐츠 전체 길이 (ms)

String com.kollus.sdk.media.MediaPlayer.getErrorString(int errorCode)

에러 코드에 해당하는 메시지 문자열을 반환합니다.

파라미터	타입	설명
`errorCode`	`int`	에러 코드

반환값: 에러 코드에 해당하는 문자열

boolean com.kollus.sdk.media.MediaPlayer.getKollusContent(KollusContent content) throws IllegalStateException

현재 재생 중인 콘텐츠의 상세 정보를 획득합니다.

파라미터	타입	설명
`content`	`KollusContent`	콘텐츠 정보를 복사할 인스턴스

반환값: 정보 획득 성공 여부

int com.kollus.sdk.media.MediaPlayer.getPlayAt()

이어보기 위치 정보를 조회합니다. nscreen 동기화 등의 기능과 연관됩니다.

반환값: 마지막으로 저장된 시청 위치 (ms)

String com.kollus.sdk.media.MediaPlayer.getPlayerName()

MediaPlayerFactory를 통해 생성된 실제 플레이어의 이름을 조회합니다.

반환값: 플레이어 이름

MediaPlayerBase.TrackInfo[] com.kollus.sdk.media.MediaPlayer.getTrackInfo() throws IllegalStateException

현재 재생 중인 콘텐츠의 트랙 정보를 조회합니다.

반환값: 트랙 정보 배열

String com.kollus.sdk.media.MediaPlayer.getVersion()

플레이어의 버전을 조회합니다.

반환값: 플레이어 버전

String com.kollus.sdk.media.MediaPlayer.getVideoCodecName()

비디오 코덱 이름을 조회합니다. 하드웨어(HW) 코덱 연동 여부를 확인하기 위해 주로 사용됩니다.

반환값: 비디오 코덱 이름

int com.kollus.sdk.media.MediaPlayer.getVideoHeight()

콘텐츠의 세로 길이를 조회합니다. onPrepared 응답을 받은 후에 정상적으로 호출할 수 있습니다.

반환값: 비디오 세로 크기 (px)

int com.kollus.sdk.media.MediaPlayer.getVideoWidth()

콘텐츠의 가로 길이를 조회합니다. onPrepared 응답을 받은 후에 정상적으로 호출할 수 있습니다.

반환값: 비디오 가로 크기 (px)

boolean com.kollus.sdk.media.MediaPlayer.isAiPlaybackRateEnabled()

현재 콘텐츠에 AI 배속 기능이 활성화되어 있는지 여부를 확인합니다.

반환값
- true: 활성화
- false: 비활성화

boolean com.kollus.sdk.media.MediaPlayer.isLooping()

현재 반복 재생 설정 여부를 확인합니다.

반환값
- true: 반복 재생 상태
- false: 반복 재생 상태 아님

boolean com.kollus.sdk.media.MediaPlayer.isPlaying()

현재 재생 중인지 여부를 확인합니다.

반환값
- true: 재생 중
- false: 재생 중 아님

void com.kollus.sdk.media.MediaPlayer.pause() throws IllegalStateException

재생을 일시정지할 때 호출합니다.

void com.kollus.sdk.media.MediaPlayer.prepareAsync()

데이터 소스(setDataSource) 설정 후 재생 준비를 비동기적으로 시작합니다. 준비가 완료되면 onPrepared 콜백이 수신됩니다.

void com.kollus.sdk.media.MediaPlayer.release()

플레이어에 할당된 자원을 회수합니다. 재생 정지(stop) 후에 호출합니다.

void com.kollus.sdk.media.MediaPlayer.seekTo(int msec) throws IllegalStateException

지정된 위치로 재생 지점을 이동합니다. (I-Frame 단위 이동)

파라미터	타입	설명
`msec`	`int`	이동할 위치 (ms)

void com.kollus.sdk.media.MediaPlayer.seekToExact(int msec) throws IllegalStateException

지정된 위치로 재생 지점을 이동합니다. (시간 단위 이동)

파라미터	타입	설명
`msec`	`int`	이동할 위치 (ms)

void com.kollus.sdk.media.MediaPlayer.selectTrack(boolean bSubTimedText, int index) throws IllegalStateException

getTrackInfo로 가져온 트랙 정보 중에서 특정 트랙(오디오, 자막 등)을 선택하여 재생할 때 호출합니다.

파라미터	타입	설명
`bSubTimedText`	`boolean`	서브 자막 트랙 여부
`index`	`int`	선택할 트랙의 인덱스

void com.kollus.sdk.media.MediaPlayer.setAiPlaybackRateEnable(boolean enable)

AI 배속 기능의 활성화 여부를 설정합니다.

파라미터	타입	설명
`enable`	`boolean`	AI 배속 기능 활성화 여부 (`true`: 활성화, `false`: 비활성화)

void com.kollus.sdk.media.MediaPlayer.setAppStatus(@APP_STATUS int status)

LMS 데이터를 전송할 때 앱의 상태 변화(백그라운드/포그라운드) 시간 정보를 함께 기록하기 위해 호출합니다.

파라미터	타입	설명
`status`	`int`	앱의 상태 값 (`APP_STATUS`)

void com.kollus.sdk.media.MediaPlayer.setAudioDelay(int timeMs)

비디오와 오디오의 싱크(Sync)를 수동으로 조절합니다.

파라미터	타입	설명
`timeMs`	`int`	조절할 시간 (ms)

void com.kollus.sdk.media.MediaPlayer.setBandwidth(int bandwidth)

콘텐츠가 ABR(Adaptive Bitrate) 방식인 경우, 특정 대역폭을 지정하여 화질을 강제로 선택합니다.

파라미터	타입	설명
`bandwidth`	`int`	선택할 대역폭 값

void com.kollus.sdk.media.MediaPlayer.setBandwidthName(String bandwidthName)

콘텐츠가 ABR 방식인 경우, 대역폭 명칭을 통해 화질을 선택합니다.

파라미터	타입	설명
`bandwidthName`	`String`	선택할 대역폭 명칭

boolean com.kollus.sdk.media.MediaPlayer.setBufferingRatio(int ratio)

기본 버퍼링량의 배수를 설정합니다. Utils.PLAYER_TYPE_KOLLUS 설정 시에만 유효합니다.

파라미터	타입	설명
`ratio`	`int`	설정할 버퍼링 배수 (범위: 1~10)

반환값
- true: 성공
- false: 실패

void com.kollus.sdk.media.MediaPlayer.setCaptureDetectLister(CaptureDetectLister listener)

화면 캡처 감지 리스너를 설정합니다.

파라미터	타입	설명
`listener`	`CaptureDetectLister`	리스너 인스턴스

void com.kollus.sdk.media.MediaPlayer.setDataSourceByKey(String mediaContentKey, String extraDrmParam)

다운로드된 로컬 콘텐츠를 재생할 때 데이터 소스를 설정합니다.

파라미터	타입	설명
`mediaContentKey`	`String`	콘텐츠 미디어 키
`extraDrmParam`	`String`	동적 DRM 다운로드 콜백 / 플레이 콜백 인자

void com.kollus.sdk.media.MediaPlayer.setDataSourceByUrl(String path, String extraDrmParam)

스트리밍 재생을 위한 데이터 소스(URL)를 설정합니다.

파라미터	타입	설명
`path`	`String`	스트리밍 콘텐츠의 경로
`extraDrmParam`	`String`	동적 DRM 다운로드 콜백 / 플레이 콜백 인자

void com.kollus.sdk.media.MediaPlayer.setDisplay(SurfaceHolder sh)

비디오가 출력될 화면을 설정합니다.

파라미터	타입	설명
`sh`	`SurfaceHolder`	비디오 출력을 담당할 `SurfaceHolder`

void com.kollus.sdk.media.MediaPlayer.setEmulatorCheckerListener(EmulatorCheckerListener listener)

에뮬레이터 환경에서 재생을 시도할 때 발생하는 이벤트를 가로채는 리스너를 설정합니다.

파라미터	타입	설명
`listener`	`EmulatorCheckerListener`	`EmulatorCheckerListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setForensicWatermarkView(ForensicWatermarkView view)

포렌식 비디오 워터마크를 출력할 뷰를 설정합니다. 포렌식 워터마크 기능 사용 시 반드시 호출해야 합니다.

파라미터	타입	설명
`view`	`ForensicWatermarkView`	워터마크 표시용 `ForensicWatermarkView` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setInitialBandwidth(int bandwidth)

재생 시작 시의 초기 대역폭을 설정합니다. prepareAsync() 이전에 호출해야 합니다.

파라미터	타입	설명
`bandwidth`	`int`	초기 시청 대역폭 `0`: 대역폭 리스트의 첫 항목부터 시작 `0`보다 큰 값: 해당 값 이하의 최적 대역폭부터 시작

void com.kollus.sdk.media.MediaPlayer.setKollusPlayerBookmarkListener(KollusPlayerBookmarkListener listener)

북마크 관련 이벤트를 처리할 리스너를 설정합니다.

파라미터	타입	설명
`listener`	`KollusPlayerBookmarkListener`	`KollusPlayerBookmarkListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setKollusPlayerLMSListener(KollusPlayerLMSListener listener)

LMS 데이터 전송 관련 이벤트를 처리할 리스너를 설정합니다.

파라미터	타입	설명
`listener`	`KollusPlayerLMSListener`	`KollusPlayerLMSListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setKollusStorage(KollusStorage storage)

StorageManager 인스턴스를 설정합니다. initialize() 호출 후 setDataSource() 호출 전 단계에서 실행합니다.

파라미터	타입	설명
`storage`	`KollusStorage`	`KollusStorage` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setLastOffsetTime(int lastOffsetTimeMs)

MPEG-DASH 콘텐츠의 전체 타임라인을 기준으로, 종료 시점부터 역산한 특정 시청 시작 위치를 설정합니다.

파라미터	타입	설명
`lastOffsetTimeMs`	`int`	종료 지점으로부터의 오프셋 시청 위치 (ms)

void com.kollus.sdk.media.MediaPlayer.setLmsOffDownloadContent(boolean bOn)

다운로드된 콘텐츠의 LMS 데이터 전송 활성화 여부를 설정합니다.

파라미터	타입	설명
`bOn`	`boolean`	데이터 전송 활성화 여부 (`true`: 활성화, `false`: 비활성화)

void com.kollus.sdk.media.MediaPlayer.setLooping(boolean looping)

콘텐츠의 반복 재생 상태를 설정합니다.

파라미터	타입	설명
`looping`	`boolean`	반복 재생 활성화 여부 (`true`: 반복 재생, `false`: 반복 안 함)

void com.kollus.sdk.media.MediaPlayer.setMinDurationForQualityIncreaseMs(int msec)

화질(대역폭) 상향 전환 전에 유지해야 할 최소 버퍼 지속 시간을 설정합니다. 기본값은 10초이며, prepareAsync() 호출 전에 설정해야 합니다.

파라미터	타입	설명
`msec`	`int`	최소 버퍼링 시간 (ms)

void com.kollus.sdk.media.MediaPlayer.setMute(boolean mute)

오디오 출력의 음소거 상태를 설정합니다.

파라미터	타입	설명
`mute`	`boolean`	음소거 활성화 여부 (`true`: 음소거 활성화, `false`: 음소거 비활성화)

boolean com.kollus.sdk.media.MediaPlayer.setNetworkTimeout(int timeout)

네트워크 연결 Timeout 시간을 설정합니다.

파라미터	타입	설명
`timeout`	`int`	네트워크 Timeout 제한 시간 (sec)

void com.kollus.sdk.media.MediaPlayer.setNotifyLastReport(boolean bOn)

플레이어 종료 시 LMS 데이터 전송 완료 여부를 UI로 통지받을지 여부를 설정합니다. 활성화 시 네트워크 환경에 따라 종료 시간이 지연될 수 있습니다.

파라미터	타입	설명
`bOn`	`boolean`	알림 활성화 여부 (`true`: 알림 활성화, `false`: 알림 비활성화)

void com.kollus.sdk.media.MediaPlayer.setOnBufferingUpdateListener(OnBufferingUpdateListener listener)

Deprecated OnBufferingUpdateListener를 설정합니다.

파라미터	타입	설명
`listener`	`OnBufferingUpdateListener`	`OnBufferingUpdateListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setOnCompletionListener(OnCompletionListener listener)

OnCompletionListener를 설정합니다.

파라미터	타입	설명
`listener`	`OnCompletionListener`	`OnCompletionListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setOnErrorListener(OnErrorListener listener)

OnErrorListener를 설정합니다.

파라미터	타입	설명
`listener`	`OnErrorListener`	`OnErrorListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setOnExternalDisplayDetectListener(OnExternalDisplayDetectListener listener)

OnExternalDisplayDetectListener를 설정합니다.

파라미터	타입	설명
`listener`	`OnExternalDisplayDetectListener`	`OnExternalDisplayDetectListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setOnInfoListener(OnInfoListener listener)

OnInfoListener를 설정합니다.

파라미터	타입	설명
`listener`	`OnInfoListener`	`OnInfoListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setOnMediaRouteInfoListener(OnMediaRouteInfoListener listener)

OnMediaRouteInfoListener를 설정합니다.

파라미터	타입	설명
`listener`	`OnMediaRouteInfoListener`	`OnMediaRouteInfoListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setOnPreparedListener(OnPreparedListener listener)

OnPreparedListener를 설정합니다.

파라미터	타입	설명
`listener`	`OnPreparedListener`	`OnPreparedListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setOnSeekCompleteListener(OnSeekCompleteListener listener)

OnSeekCompleteListener를 설정합니다.

파라미터	타입	설명
`listener`	`OnSeekCompleteListener`	`OnSeekCompleteListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setOnTimedTextDetectListener(OnTimedTextDetectListener listener)

OnTimedTextDetectListener를 설정합니다.

파라미터	타입	설명
`listener`	`OnTimedTextDetectListener`	`OnTimedTextDetectListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setOnTimedTextListener(OnTimedTextListener listener)

OnTimedTextListener를 설정합니다.

파라미터	타입	설명
`listener`	`OnTimedTextListener`	`OnTimedTextListener` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setOnVideoSizeChangedListener(OnVideoSizeChangedListener listener)

OnVideoSizeChangedListener를 설정합니다.

파라미터	타입	설명
`listener`	`OnVideoSizeChangedListener`	`OnVideoSizeChangedListener` 인스턴스

boolean com.kollus.sdk.media.MediaPlayer.setPlayingRate(float playing_rate)

배속을 설정합니다. 오디오 워터마크가 포함된 콘텐츠는 최대 1.5배속으로 제한되며, 2.0배속 초과 시 프레임 드롭(Frame Drop)이 발생할 수 있습니다.

파라미터	타입	설명
`playing_rate`	`float`	설정할 배속 값 (범위: 0.5~10.0)

반환값
- true: 성공
- false: 실패

void com.kollus.sdk.media.MediaPlayer.setRemoteMediaRouteInfo(String castNameSpace)

크롬캐스트(Chromecast) 리시버와 메시지 송수신 시 사용되는 네임스페이스(Namespace)를 설정합니다. prepareAsync() 호출 전 설정해야 합니다.

파라미터	타입	설명
`castNameSpace`	`String`	크롬캐스트 리시버와 통신에 사용하는 네임스페이스. Kollus Cast Receiver 사용 시 `MediaPlayer.CAST_NAME_SPACE` 지정

void com.kollus.sdk.media.MediaPlayer.setScreenOnWhilePlaying(boolean screenOn)

콘텐츠 재생 중 화면 상시 켜짐 상태 유지 여부를 설정합니다.

파라미터	타입	설명
`screenOn`	`boolean`	화면 상시 켜짐 활성화 여부 (`true`: 상시 켜짐 상태 유지, `false`: 시스템 설정에 따른 자동 꺼짐 적용)

void com.kollus.sdk.media.MediaPlayer.setSurface(Surface surface)

비디오 출력 화면을 설정합니다.

파라미터	타입	설명
`surface`	`Surface`	비디오 화면이 출력될 `Surface` 인스턴스

void com.kollus.sdk.media.MediaPlayer.setVideoRending(boolean bRendering)

비디오 렌더링 수행 여부를 설정합니다.

파라미터	타입	설명
`bRendering`	`boolean`	렌더링 수행 여부 (`true`: 렌더링 수행, `false`: 렌더링 미수행)

void com.kollus.sdk.media.MediaPlayer.skip()

인트로 영상이 있는 경우, 현재 재생 중인 콘텐츠의 건너뛰기를 수행합니다.

void com.kollus.sdk.media.MediaPlayer.start()

일시정지 후 재생을 재개하거나 onPrepared 이벤트 수신 후 재생을 시작할 때 호출합니다.

void com.kollus.sdk.media.MediaPlayer.stop()

재생 중인 콘텐츠를 정지합니다.

boolean com.kollus.sdk.media.MediaPlayer.supportPlaybackrateControl()

현재 플레이어의 배속 조절 기능 지원 여부를 조회합니다.

반환값
- true: 배속 지원
- false: 배속 지원 안 함

void com.kollus.sdk.media.MediaPlayer.updateKollusBookmark(int position, String label)

특정 시점에 북마크 정보를 추가합니다. 성공 여부는 onBookmarkInfoUpdated를 통해 반환됩니다.

파라미터	타입	설명
`position`	`int`	북마크 저장 위치 (ms)
`label`	`String`	북마크 레이블

Property Details

static final int com.kollus.sdk.media.MediaPlayer.APP_STATUS_BACKGROUND = 1

애플리케이션의 백그라운드 실행 상태 정의 상수입니다.

static final int com.kollus.sdk.media.MediaPlayer.APP_STATUS_FOREGROUND = 2

애플리케이션의 포그라운드 실행 상태 정의 상수입니다.

static final int com.kollus.sdk.media.MediaPlayer.MEDIA_ERROR_NOT_VALID_FOR_PROGRESSIVE_PLAYBACK = 200

MPEG4BOX 컨테이너 구조 결함으로 인한 프로그레시브 재생 불가 에러 코드입니다.

참고: OnErrorListener

static final int com.kollus.sdk.media.MediaPlayer.MEDIA_ERROR_UNKNOWN = 1

원인을 파악할 수 없는 미확인 에러 코드입니다.

참고: OnErrorListener

static final int com.kollus.sdk.media.MediaPlayer.MEDIA_INFO_FRAME_RATE = 7

비디오 프레임레이트(Framerate) 정보 조회를 위한 상태 코드입니다.

참고: OnInfoListener

MediaPlayer Class​

Classes & Interfaces​

Public Methods​

Static Public Properties​

Protected Methods​

Constructors & Destructors​

Method Details​

Property Details​