メインコンテンツまでスキップ

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: エラーコード