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

Utils

BandwidthItem Class​

com.kollus.sdk.media.content.BandwidthItem

アダプティブビットレート(ABR) コンテンツ再生時に、現在再生中のビデオの帯域幅情報を管理・識別するためのクラスです。

Public Methods​

  • BandwidthItem(int bandwidth, String bandwidthName)
  • int getBandwidth()
  • String getBandwidthName()

Constructors & Destructors​

com.kollus.sdk.media.content.BandwidthItem.BandwidthItem(int bandwidth, String bandwidthName)

Internal SDK Only  帯域幅情報を管理するオブジェクトを生成します。

  • パラメーター
    • bandwidth: 帯域幅の値
    • bandwidthName: 帯域幅の識別名

Method Details​

int com.kollus.sdk.media.content.BandwidthItem.getBandwidth()

onChangedBandwidth コールバックが発生した際に、現在再生中のビデオの実際の帯域幅の値を返します。

  • 戻り値: 帯域幅 (bps)
String com.kollus.sdk.media.content.BandwidthItem.getBandwidthName()

onChangedBandwidth コールバックが発生した際に、現在再生中のビデオの帯域幅名を返します。 解像度情報が存在する場合は '1080P' のような形式で返され、情報がない場合は Kbps 単位の数値で返されます。

  • 戻り値: 帯域幅の識別名 (例: '1080P' または '5000Kbps')

Utils Class​

com.kollus.sdk.media.util.Utils

SDK 内部およびアプリケーション開発時に汎用的に使用されるユーティリティクラスです。

Static Public Methods​

  • static<T> T checkNotNull(T object)
  • static void closeSilently(Closeable c)
  • static void closeSilently(ParcelFileDescriptor fd)
  • static void closeSilently(Cursor cursor)
  • static void deleteDirectory(String path)
  • static long getAvailableMemorySize(String path)
  • static DEVICE_TYPE getDeviceType(Context context)
  • static String getDirectoryJSON(Context context, String prefKey)
  • static String getDirectoryJSONByPath(Context context, String path, String prefKey)
  • static File[] getExternalFilesDirs(@NonNull Context context, @Nullable String type)
  • static String getFileMD5(File updateFile)
  • static long getFolderSize(File directory)
  • static String getPlayerId(Context context)
  • static String getPlayerIdMd5(Context context)
  • static String getPlayerIdSha1(Context context)
  • static String getStoragePath(Context context)
  • static String getString(JSONObject json, String key)
  • static long getTotalMemorySize(String path)
  • static Object invoke(Object obj, String methodName, Object[] objList)
  • static boolean isRooting()
  • static boolean makeDirectory(String path)
  • static String makeMD5(String param)
  • static String makeSHA1(String param)
  • static void saveDirectoryJSON(Context context, String dbPath, String jsonString)
  • static void setPlayerId(String id)
  • static void setStoragePath(Context context, String path)
  • static String stringForTime(String dayString, String hourString, String minString, String secString, int timeMs)
  • static String stringForTime(int timeMs)
  • static String stringForTimeHHMMSS(int timeMs)
  • static String stringForTimeHMMSS(int timeMs)
  • static String stringForTimeMMSS(int timeMs)

Static Public Properties​

  • static final int PLAYER_TYPE_NONE = 0
  • static final int PLAYER_TYPE_NATIVE = 1
  • static final int PLAYER_TYPE_KOLLUS = 2
  • static final int PLAYER_TYPE_EXO = 3
  • static final boolean USE_EXO_PLAYER = false

Method Details​

static void com.kollus.sdk.media.util.Utils.deleteDirectory(String path)

指定されたパスのディレクトリを削除します。

  • パラメーター
    • path: ディレクトリパス
static long com.kollus.sdk.media.util.Utils.getAvailableMemorySize(String path)

指定されたパス（内部メモリまたは SD カード）の使用可能な空き容量を取得します。

  • パラメーター
    • path: 空き容量を確認するストレージパス
  • 戻り値: 残余容量
static DEVICE_TYPE com.kollus.sdk.media.util.Utils.getDeviceType(Context context)

現在アプリケーションが実行中のデバイスのタイプを取得します。

  • パラメーター
    • context: アプリケーションコンテキスト
  • 戻り値: デバイスタイプ (参照: DEVICE_TYPE)
static String com.kollus.sdk.media.util.Utils.getDirectoryJSON(Context context, String prefKey)

ディレクトリ構造の JSON データを読み込みます。

  • パラメーター
    • context: アプリケーションコンテキスト
    • prefKey: 保存された JSON データのキー
  • 戻り値: JSON データ
static String com.kollus.sdk.media.util.Utils.getDirectoryJSONByPath(Context context, String path, String prefKey)

指定したパスのディレクトリ構造 JSON データを読み込みます。

  • パラメーター
    • context: アプリケーションコンテキスト
    • path: データが保存されているファイルパス
    • prefKey: 保存された JSON データのキー
  • 戻り値: JSON データ
static String com.kollus.sdk.media.util.Utils.getFileMD5(File updateFile)

指定されたファイルのデータ整合性検証のための MD5 チェックサム(Checksum) を抽出します。

  • パラメーター
    • updateFile: チェックサムを生成するファイル
  • 戻り値: MD5 ハッシュ文字列
static long com.kollus.sdk.media.util.Utils.getFolderSize(File directory)

指定されたディレクトリの容量を取得します。

  • パラメーター
    • directory: ディレクトリ
  • 戻り値: 合計使用容量
static String com.kollus.sdk.media.util.Utils.getPlayerId(Context context)

デバイスに割り当てられたプレイヤー ID を取得します。

  • パラメーター
    • context: アプリケーションコンテキスト
  • 戻り値: プレイヤー ID
static String com.kollus.sdk.media.util.Utils.getPlayerIdMd5(Context context)

内部ロジック用に使用する MD5 ベースのプレイヤー ID を生成します。(16 進数(hex) 文字列 32 文字)

  • パラメーター
    • context: アプリケーションコンテキスト
  • 戻り値: MD5 ハッシュ処理されたプレイヤー ID
static String com.kollus.sdk.media.util.Utils.getPlayerIdSha1(Context context)

外部システム識別用の SHA-1 ベースのプレイヤー ID を生成します。(長さ制限なし)

  • パラメーター
    • context: アプリケーションコンテキスト
  • 戻り値: SHA-1 ハッシュ処理されたプレイヤー ID
static String com.kollus.sdk.media.util.Utils.getStoragePath(Context context)

現在プレイヤーがコンテンツの保存・管理に使用しているストレージパスを取得します。

  • パラメーター
    • context: アプリケーションコンテキスト
  • 戻り値: ストレージパス
static String com.kollus.sdk.media.util.Utils.getString(JSONObject json, String key)

JSON オブジェクトから指定されたキー(Key) に対応する文字列値を抽出します。

  • パラメーター
    • json: JSON データ
    • key: キー
  • 戻り値: 該当キーの文字列値
static long com.kollus.sdk.media.util.Utils.getTotalMemorySize(String path)

指定されたパス（内部メモリまたは SD カード）の全体の物理的容量を取得します。

  • パラメーター
    • path: パス
  • 戻り値: 全体容量
static Object com.kollus.sdk.media.util.Utils.invoke(Object obj, String methodName, Object[] objList)

特定のクラスのメソッドを動的に実行(Invoke) します。

  • パラメーター
    • obj: 対象メソッドが含まれるクラスオブジェクト
    • methodName: 実行するメソッド名
    • objList: メソッド実行時に渡す引数(Arguments) リスト
  • 戻り値: 実行されたメソッドの戻り値オブジェクト
static boolean com.kollus.sdk.media.util.Utils.isRooting()

現在のデバイスのルーティング(Rooting) 状態を確認します。

  • 戻り値: ルーティングの有無
static boolean com.kollus.sdk.media.util.Utils.makeDirectory(String path)

指定されたパスに新しいディレクトリを作成します。

  • パラメーター
    • path: パス
  • 戻り値
    • true: 成功
    • false: 失敗
static String com.kollus.sdk.media.util.Utils.makeMD5(String param)

入力された文字列を MD5 ハッシュアルゴリズムによってチェックサムデータに変換します。

  • パラメーター
    • param: ハッシュを生成する文字列
  • 戻り値: 生成された MD5 ハッシュ文字列
static String com.kollus.sdk.media.util.Utils.makeSHA1(String param)

入力された文字列を SHA-1 ハッシュアルゴリズムによってチェックサムデータに変換します。

  • パラメーター
    • param: ハッシュを生成する文字列
  • 戻り値: 生成された SHA-1 ハッシュ文字列
static void com.kollus.sdk.media.util.Utils.saveDirectoryJSON(Context context, String dbPath, String jsonString)

ディレクトリ構造を表す JSON データを指定されたローカルパスに永続的に保存します。

  • パラメーター
    • context: アプリケーションコンテキスト
    • dbPath: 保存先の場所
    • jsonString: 保存する JSON データ
static void com.kollus.sdk.media.util.Utils.setPlayerId(String id)

外部から手動でプレイヤー ID を指定します。

  • パラメーター
    • id: プレイヤー ID
static void com.kollus.sdk.media.util.Utils.setStoragePath(Context context, String path)

プレイヤーがコンテンツのダウンロードおよび管理に使用するデフォルトのストレージパスを指定します。

  • パラメーター
    • context: アプリケーションコンテキスト
    • path: パス
static String com.kollus.sdk.media.util.Utils.stringForTime(int timeMs)

ミリ秒(ms) 単位の時間を、再生時刻表示に適した文字列形式（例: 1:10:59 または 10:59）に変換します。

  • パラメーター
    • timeMs: 変換する時間データ (ms)
  • 戻り値: 変換された時間文字列
static String com.kollus.sdk.media.util.Utils.stringForTime(String dayString, String hourString, String minString, String secString, int timeMs)

ミリ秒(ms) 単位の時間を '1 日 1 時間 1 分 1 秒' の形式に変換します。

  • パラメーター
    • dayString: 日付の区切り文字
    • hourString: 時間の区切り文字
    • minString: 分の区切り文字
    • secString: 秒の区切り文字
    • timeMs: 変換する時間データ (ms)
  • 戻り値: 変換された時間文字列
static String com.kollus.sdk.media.util.Utils.stringForTimeHHMMSS(int timeMs)

ミリ秒(ms) 単位の時間を 00:00:00 形式（時:分:秒、各 2 桁固定）の文字列に変換します。

  • パラメーター
    • timeMs: 変換する時間データ (ms)
  • 戻り値: 変換された時間文字列
static String com.kollus.sdk.media.util.Utils.stringForTimeHMMSS(int timeMs)

ミリ秒(ms) 単位の時間を 0:00:00 形式（時:分:秒）の文字列に変換します。

  • パラメーター
    • timeMs: 変換する時間データ (ms)
  • 戻り値: 変換された時間文字列
static String com.kollus.sdk.media.util.Utils.stringForTimeMMSS(int timeMs)

ミリ秒(ms) 単位の時間を 00:00 形式（分:秒）の文字列に変換します。

  • パラメーター
    • timeMs: 変換する時間データ (ms)
  • 戻り値: 変換された時間文字列

Property Details​

属性値説明
PLAYER_TYPE_EXO3ExoPlayer エンジン (Android 4.1 Jelly Bean、API Level 16 以上をサポート)
PLAYER_TYPE_KOLLUS2Kollus セキュアプレイヤー
PLAYER_TYPE_NATIVE1内蔵プレイヤー
PLAYER_TYPE_NONE0プレイヤーエンジンが生成されていないか、指定されていない状態