본문으로 건너뛰기

Chapter & Subtitle

Chapter Class​

com.kollus.sdk.media.content.KollusContent.ChapterInfo.Chapter

콘텐츠의 특정 시점을 정의하는 챕터(Chapter)의 상세 정보를 관리하는 클래스입니다.

Public Methods​

  • int getPosition()
  • String getValue()

Method Details​

int com.kollus.sdk.media.content.KollusContent.ChapterInfo.Chapter.getPosition()

전체 영상 내에서 해당 챕터가 시작되는 시간 정보를 반환합니다.

  • 반환값: 챕터 시작 시각 (sec)
String com.kollus.sdk.media.content.KollusContent.ChapterInfo.Chapter.getValue()

챕터의 명칭 또는 설명을 반환합니다. 플레이어의 챕터 목록에 노출되는 텍스트로 활용됩니다.

  • 반환값: 챕터 명칭 또는 설명

ChapterInfo Class​

com.kollus.sdk.media.content.KollusContent.ChapterInfo

콘텐츠의 챕터(Chapter) 데이터 세트를 관리하는 클래스입니다. 특정 언어 설정값과 해당 언어로 작성된 상세 챕터 리스트를 포함합니다.

Public Methods​

  • List<Chapter> getChapters()
  • String getLanguage()

Method Details​

List<Chapter> com.kollus.sdk.media.content.KollusContent.ChapterInfo.getChapters()

콘텐츠 내에 정의된 챕터 목록을 반환합니다.

  • 반환값: 챕터 리스트
String com.kollus.sdk.media.content.KollusContent.ChapterInfo.getLanguage()

해당 챕터 세트에 설정된 언어 코드를 반환합니다. 다국어를 지원하는 콘텐츠의 경우 각 언어별 챕터 구분을 위해 사용됩니다.

  • 반환값: 언어 코드

OnTimedTextDetectListener Interface​

com.kollus.sdk.media.MediaPlayer.OnTimedTextDetectListener

addTimedTextSource()를 통한 자막 추가 또는 미디어 스트림 내 포함된 자막이 감지되었을 때 상태를 수신하는 인터페이스입니다.

Public Methods​

  • void onSubTimedTextDetect(MediaPlayer mp, int trackIndex)
  • void onTimedTextDetect(MediaPlayer mp, int trackIndex)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnTimedTextDetectListener.onSubTimedTextDetect(MediaPlayer mp, int trackIndex)

콘텐츠 내에서 재생 가능한 서브 자막이 발견되었을 때 호출됩니다.

파라미터타입설명
mpMediaPlayer플레이어 인스턴스
trackIndexint자막 인덱스
void com.kollus.sdk.media.MediaPlayer.OnTimedTextDetectListener.onTimedTextDetect(MediaPlayer mp, int trackIndex)

콘텐츠 내에서 재생 가능한 메인 자막이 발견되었을 때 호출됩니다.

파라미터타입설명
mpMediaPlayer플레이어 인스턴스
trackIndexint자막 인덱스

OnTimedTextListener Interface​

com.kollus.sdk.media.MediaPlayer.OnTimedTextListener

재생 시점(Timeline)에 동기화된 자막 데이터를 수신하는 인터페이스입니다.

Public Methods​

  • void onSubTimedText(MediaPlayer mp, String text)
  • void onTimedImage(MediaPlayer mp, byte[] image, int width, int height)
  • void onTimedText(MediaPlayer mp, String text)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnTimedTextListener.onSubTimedText(MediaPlayer mp, String text)

텍스트 형식의 서브 자막 데이터를 수신하는 시점에 호출됩니다.

파라미터타입설명
mpMediaPlayer플레이어 인스턴스
textString현재 재생 시점에 해당하는 서브 자막 문자열
void com.kollus.sdk.media.MediaPlayer.OnTimedTextListener.onTimedImage(MediaPlayer mp, byte[]  image, int width, int height)

이미지 형식의 자막(VobSub) 데이터를 수신하는 시점에 호출됩니다.

파라미터타입설명
mpMediaPlayer플레이어 인스턴스
imagebyte[]자막 이미지의 비트맵 데이터
widthint자막 이미지의 가로 길이
heightint자막 이미지의 세로 길이
void com.kollus.sdk.media.MediaPlayer.OnTimedTextListener.onTimedText(MediaPlayer mp, String text)

텍스트 형식의 메인 자막 데이터를 수신하는 시점에 호출됩니다.

파라미터타입설명
mpMediaPlayer플레이어 인스턴스
textString현재 재생 시점에 해당하는 메인 자막 문자열

SubtitleInfo Class​

com.kollus.sdk.media.content.KollusContent.SubtitleInfo

콘텐츠에 포함된 개별 자막의 메타데이터를 관리하는 클래스입니다.

Public Properties​

  • String name
  • String url
  • String languageCode
  • boolean ai

Property Details​

속성타입설명
languageCodeString자막의 언어 코드
nameString자막의 언어 명칭
urlString자막 데이터를 로드하기 위한 리소스 경로
aibooleanAI 자막 서비스로 생성한 자막인지 여부