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	String	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	String	북마크 레이블

void com.kollus.sdk.media.content.KollusBookmark.setLevel(int level)

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

파라미터	타입	설명
level	int	설정할 북마크 레벨 값

void com.kollus.sdk.media.content.KollusBookmark.setThumbnail(Bitmap bm)

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

파라미터	타입	설명
bm	Bitmap	설정할 섬네일 비트맵 이미지

void com.kollus.sdk.media.content.KollusBookmark.setTime(int time)

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

파라미터	타입	설명
time	int	북마크를 설정할 재생 시점 (sec)

void com.kollus.sdk.media.content.KollusBookmark.setTitle(String title)

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

파라미터	타입	설명
title	String	북마크 식별 명칭

Property Details

속성	값	설명
MAX_BOOKMARK	1000	단일 콘텐츠당 등록 가능한 최대 북마크 개수
PROVIDER_LEVEL	1	고객사가 사전에 설정한 북마크 레벨
USER_LEVEL	0	시청자가 직접 추가한 북마크 레벨
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	List<KollusBookmark>	북마크 리스트
bWritable	boolean	사용자 북마크 추가 가능 여부 (true: 가능, false: 불가)

void com.kollus.sdk.media.KollusPlayerBookmarkListener.onBookmarkDeleted(int position, boolean bDeleted)

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

파라미터	타입	설명
position	int	삭제된 북마크의 위치 (sec)
bDeleted	boolean	삭제 성공 여부

void com.kollus.sdk.media.KollusPlayerBookmarkListener.onBookmarkUpdated(int position, boolean bUpdated)

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

파라미터	타입	설명
position	int	업데이트된 북마크의 위치 (sec)
bUpdated	boolean	업데이트 성공 여부

void com.kollus.sdk.media.KollusPlayerBookmarkListener.onGetBookmarkError(int nErrorCode)

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

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