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

Player Callbacks

お知らせ

このドキュメントは機械翻訳で作成された下書きであり、現在レビュー中です。機械翻訳の特性上、一部の内容が不正確であったり、韓国語の原文と異なる場合があります。より正確な情報については、韓国語のドキュメントをご参照ください。

OnCompletionListener Interface​

com.kollus.sdk.media.MediaPlayer.OnCompletionListener

コンテンツの再生完了イベントを受信するインターフェースです。

Public Methods​

  • void onCompletion(MediaPlayer mp)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnCompletionListener.onCompletion(MediaPlayer mp)

再生が完了した時点で呼び出されます。

  • パラメーター
    • mp: 再生が完了したプレイヤーインスタンス

OnErrorListener Interface​

com.kollus.sdk.media.MediaPlayer.OnErrorListener

再生中に発生するエラー情報を受信するインターフェースです。

Public Methods​

  • boolean onError(MediaPlayer mp, int what, int extra)

Method Details​

boolean com.kollus.sdk.media.MediaPlayer.OnErrorListener.onError(MediaPlayer mp, int what, int extra)

再生中に予期しないエラーが発生した際に呼び出されます。

  • パラメーター
    • mp: エラーが発生したプレイヤーインスタンス
    • what: エラーコード 1
    • extra: エラーコード 2
  • 戻り値
    • true: アプリケーション(UI)側でエラー処理完了
    • false: エラー処理を委譲（false を返すと、SDK 内部で自動的に onComplete が呼び出され、再生セッションが終了します）

OnInfoListener Interface​

com.kollus.sdk.media.MediaPlayer.OnInfoListener

再生中に発生するステータス情報(Info)および警告(Warning)イベントを受信するインターフェースです。

Public Methods​

  • void onBufferingEnd(MediaPlayer mp)
  • void onBufferingStart(MediaPlayer mp)
  • void onChangedBandwidth(MediaPlayer mp, BandwidthItem item)
  • void onCodecInitFail(MediaPlayer mp, String componentName)
  • void onDetectBandwidthList(MediaPlayer mp, List<BandwidthItem> list)
  • void onDownloadRate(MediaPlayer mp, int downloadRate)
  • void onFrameDrop(MediaPlayer mp)
  • boolean onInfo(MediaPlayer mp, int what, int extra)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onBufferingEnd(MediaPlayer mp)

データの読み込みが完了し、バッファリング状態が解除された時点で呼び出されます。

  • パラメーター
    • mp: プレイヤーインスタンス
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onBufferingStart(MediaPlayer mp)

ネットワーク環境などによりデータの読み込み（バッファリング）が開始された時点で呼び出されます。

  • パラメーター
    • mp: プレイヤーインスタンス
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onChangedBandwidth(MediaPlayer mp, BandwidthItem item)

アダプティブビットレート(ABR)コンテンツの再生中にビットレートが変更された時点で呼び出されます。

  • パラメーター
    • mp: プレイヤーインスタンス
    • item: 変更されたビットレート情報
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onCodecInitFail(MediaPlayer mp, String componentName)

ハードウェアコーデックの初期化に失敗した際に呼び出されます。（オーディオウォーターマークを含むコンテンツ、または Android 4.3 Jelly Bean MR2 未満のデバイスに限り発生）

  • パラメーター
    • mp: プレイヤーインスタンス
    • componentName: 初期化に失敗したコーデック名
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onDetectBandwidthList(MediaPlayer mp, List<BandwidthItem>  list)

アダプティブビットレート(ABR)コンテンツの再生時、サービスでサポート可能な全帯域幅リストが検出された際に呼び出されます。

  • パラメーター
    • mp: プレイヤーインスタンス
    • list: 全帯域幅情報リスト
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onDownloadRate(MediaPlayer mp, int downloadRate)

コンテンツファイルのダウンロード完了時、該当ファイルの平均ダウンロード転送速度を返します。

  • パラメーター
    • mp: プレイヤーインスタンス
    • downloadRate: 平均ダウンロード速度(bps)
void com.kollus.sdk.media.MediaPlayer.OnInfoListener.onFrameDrop(MediaPlayer mp)

ビデオフレームドロップ(Frame Drop)が発生した際に呼び出されます。（オーディオウォーターマークを含むコンテンツ、または Android 4.3 Jelly Bean MR2 未満のデバイスに限り発生）

  • パラメーター
    • mp: プレイヤーインスタンス
boolean com.kollus.sdk.media.MediaPlayer.OnInfoListener.onInfo(MediaPlayer mp, int what, int extra)

プレイヤーのステータス情報またはイベント発生時に呼び出されます。

  • パラメーター
    • mp: プレイヤーインスタンス
    • what: 情報タイプ
    • extra: その他のデータ

OnPreparedListener Interface​

com.kollus.sdk.media.MediaPlayer.OnPreparedListener

再生準備完了イベントを受信するインターフェースです。

Public Methods​

  • void onPrepared(MediaPlayer mp)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnPreparedListener.onPrepared(MediaPlayer mp)

再生準備が正常に完了した時点で呼び出されます。

  • パラメーター
    • mp: 再生準備が完了したプレイヤーインスタンス

OnSeekCompleteListener Interface​

com.kollus.sdk.media.MediaPlayer.OnSeekCompleteListener

再生位置の移動(Seek)リクエストが完了したことを受信するインターフェースです。

Public Methods​

  • void onSeekComplete(MediaPlayer mp)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnSeekCompleteListener.onSeekComplete(MediaPlayer mp)

再生位置の変更操作が正常に完了した時点で呼び出されます。

  • パラメーター
    • mp: 再生位置の移動が完了したプレイヤーインスタンス

OnVideoSizeChangedListener Interface​

com.kollus.sdk.media.MediaPlayer.OnVideoSizeChangedListener

コンテンツの初期解像度情報の確認、および再生中に解像度が変更された際の情報を受信するインターフェースです。

Public Methods​

  • void onVideoSizeChanged(MediaPlayer mp, int width, int height)

Method Details​

void com.kollus.sdk.media.MediaPlayer.OnVideoSizeChangedListener.onVideoSizeChanged(MediaPlayer mp, int width, int height)

ビデオの横・縦サイズが初めて識別された際、または再生中に解像度が切り替わった際に呼び出されます。

  • パラメーター
    • mp: プレイヤーインスタンス
    • width: ビデオの横解像度
    • height: ビデオの縦解像度

KollusPlayerLMSListener Interface​

com.kollus.sdk.media.KollusPlayerLMSListener

ユーザーの再生進行率を学習管理システム(LMS)サーバーへ送信し、その応答結果を受信するインターフェースです。

Public Methods​

  • void onLMS(String request, String response)

Method Details​

void com.kollus.sdk.media.KollusPlayerLMSListener.onLMS(String request, String response)

ユーザーの再生進行率データをサーバーに送信した際に発生し、送信したメッセージとサーバーの応答メッセージを受け取ります。

  • パラメーター
    • request: LMS サーバーへ送信された再生進行率に関するデータメッセージ
    • response: 送信結果に対してサーバーから受信した応答メッセージ

KollusPlayerThumbnailListener Interface​

com.kollus.sdk.media.KollusPlayerThumbnailListener

コンテンツのロード時に非同期スレッド方式で行われるサムネイル画像のダウンロードおよびキャッシュ状態を受信するインターフェースです。

Public Methods​

  • void onCached(int index, int nErrorCode, String savePath)

Method Details​

void com.kollus.sdk.media.KollusPlayerThumbnailListener.onCached(int index, int nErrorCode, String savePath)

サムネイルのダウンロードがスレッド方式で実行される際、各コンテンツのダウンロード結果（成功または失敗）を受信します。

  • パラメーター
    • index: 識別番号（KollusContent の getUriIndex 値）
    • nErrorCode: ダウンロード結果エラーコード（0 の場合は成功）
    • savePath: ローカルデバイスにサムネイルが保存された物理パス