본문으로 건너뛰기

Bookmark

KollusBookmark Class​

com.kollus.sdk.media.content.KollusBookmark

영상 콘텐츠의 특정 재생 시점에 대한 정보(시간, 제목, 이미지 등)를 저장하고 관리하는 클래스입니다. 시청자가 직접 추가하거나 고객사 측에서 사전 설정한 북마크 데이터를 취급합니다.

Public Methods​

  • KollusBookmark()
  • int describeContents()
  • String getLabel()
  • int getLevel()
  • Bitmap getThumbnail()
  • int getTime()
  • String getTitle()
  • void setLabel(String label)
  • void setLevel(int level)
  • void setThumbnail(Bitmap bm)
  • void setTime(int time)
  • void setTitle(String title)
  • void writeToParcel(Parcel dest, int flags)

Static Public Methods​

  • static ArrayList<KollusBookmark> getBookmarkInfo(String jsonString)

Static Public Properties​

  • static final int NO_LEVEL = -1
  • static final int USER_LEVEL = 0
  • static final int PROVIDER_LEVEL = 1
  • static final int MAX_BOOKMARK = 1000

Constructors & Destructors​

com.kollus.sdk.media.content.KollusBookmark.KollusBookmark()

Internal SDK Only  북마크 객체를 생성합니다.

Method Details​

static ArrayList<KollusBookmark> com.kollus.sdk.media.content.KollusBookmark.getBookmarkInfo(String jsonString)

Internal SDK Only  JSON 형식의 문자열 데이터를 파싱하여 KollusBookmark 객체 리스트로 변환합니다.

  • 파라미터
    • jsonString: JSON 형식의 북마크 데이터 문자열
  • 반환값: 북마크 리스트
String com.kollus.sdk.media.content.KollusBookmark.getLabel()

북마크 레이블을 조회합니다.

  • 반환값: 북마크 레이블
int com.kollus.sdk.media.content.KollusBookmark.getLevel()

북마크의 생성 주체(레벨)를 확인합니다.

  • 반환값: 북마크 레벨 (USER_LEVEL, PROVIDER_LEVEL)
Bitmap com.kollus.sdk.media.content.KollusBookmark.getThumbnail()

북마크 설정 지점의 영상 화면을 캡처한 섬네일 이미지를 조회합니다.

  • 반환값: 북마크 섬네일 비트맵
int com.kollus.sdk.media.content.KollusBookmark.getTime()

북마크가 설정된 시점을 확인합니다.

  • 반환값: 북마크 설정 시점 (sec)
String com.kollus.sdk.media.content.KollusBookmark.getTitle()

북마크의 명칭(제목)을 조회합니다.

  • 반환값: 북마크 식별 명칭
void com.kollus.sdk.media.content.KollusBookmark.setLabel(String label)

북마크 레이블을 설정합니다.

  • 파라미터
    • label: 북마크 레이블
void com.kollus.sdk.media.content.KollusBookmark.setLevel(int level)

북마크의 생성 주체(레벨)를 설정합니다.

  • 파라미터
    • level: 설정할 북마크 레벨 값
void com.kollus.sdk.media.content.KollusBookmark.setThumbnail(Bitmap bm)

북마크 지점에 표시할 섬네일 이미지를 설정합니다.

  • 파라미터
    • bm: 설정할 섬네일 비트맵 이미지
void com.kollus.sdk.media.content.KollusBookmark.setTime(int time)

북마크를 저장할 재생 시점 정보를 설정합니다.

  • 파라미터
    • time: 북마크를 설정할 재생 시점 (sec)
void com.kollus.sdk.media.content.KollusBookmark.setTitle(String title)

북마크의 명칭(제목)을 설정합니다.

  • 파라미터
    • title: 북마크 식별 명칭

Property Details​

속성값설명
MAX_BOOKMARK1000단일 콘텐츠당 등록 가능한 최대 북마크 개수
PROVIDER_LEVEL1고객사가 사전에 설정한 북마크 레벨
USER_LEVEL0시청자가 직접 추가한 북마크 레벨
NO_LEVEL-1레벨 정보가 지정되지 않은 상태

KollusPlayerBookmarkListener Interface​

com.kollus.sdk.media.KollusPlayerBookmarkListener

콘텐츠의 북마크 데이터 로드, 추가, 수정, 삭제 등 북마크와 관련된 모든 이벤트 상태를 수신하는 인터페이스입니다.

Public Methods​

  • void onBookmark(List<KollusBookmark> bookmark, boolean bWritable)
  • void onBookmarkDeleted(int position, boolean bDeleted)
  • void onBookmarkUpdated(int position, boolean bUpdated)
  • void onGetBookmarkError(int nErrorCode)

Method Details​

void com.kollus.sdk.media.KollusPlayerBookmarkListener.onBookmark(List<KollusBookmark> bookmark, boolean bWritable)

공식 북마크(고객사 설정)나 내 북마크(시청자 설정)가 존재할 때 호출됩니다.

  • 파라미터
    • bookmark: 북마크 리스트
    • bWritable: 사용자 북마크 추가 가능 여부 (true: 가능, false: 불가)
void com.kollus.sdk.media.KollusPlayerBookmarkListener.onBookmarkDeleted(int position, boolean bDeleted)

북마크가 삭제된 시점에 호출됩니다. 네트워크 상황에 따라 삭제 요청 후 실제 호출까지 시간이 걸릴 수 있습니다.

  • 파라미터
    • position: 삭제된 북마크의 위치 (ms)
    • bDeleted: 삭제 성공 여부 (true: 성공, false: 실패)
void com.kollus.sdk.media.KollusPlayerBookmarkListener.onBookmarkUpdated(int position, boolean bUpdated)

북마크가 추가되거나 업데이트된 시점에 호출됩니다. 네트워크 상황에 따라 추가 요청 후 실제 호출까지 시간이 걸릴 수 있습니다.

  • 파라미터
    • position: 업데이트된 북마크의 위치 (ms)
    • bUpdated: 업데이트 성공 여부 (true: 성공, false: 실패)
void com.kollus.sdk.media.KollusPlayerBookmarkListener.onGetBookmarkError(int nErrorCode)

네트워크 오류, JSON 파싱 오류, 또는 서버 응답 JSON의 error 필드 값이 0이 아닐 때 호출됩니다.

  • 파라미터
    • nErrorCode: 에러 코드