API リファレンス - ApsaraVideo VOD - Alibaba Cloud ドキュメントセンター

このトピックでは、AliPlayerKit の主要な API について説明します。コア API、スロットシステム、ビデオソース、プレーヤーインターフェイス、状態ストレージ、イベントシステム、ロギングシステム、プリロードインターフェイス、ライフサイクルポリシー、ストラテジーシステムについて説明します。

説明

AliPlayerKit は、すべてのコア API (クラスとメソッドを含む) に完全なコードコメントを提供します。Android Studio などの IDE では、ホバーヒントやクイックドキュメント機能を使用してこれらのコメントを表示し、開発効率を向上させることができます。これらのコメントにより、AI プログラミングツールが API にアクセスしやすくなり、API のセマンティクスをより深く理解できるようになります。

コア API

AliPlayerKit (グローバルインターフェイス)

AliPlayerKit クラスは、グローバルな構成と初期化を提供します。これは、プレーヤーフレームワーク全体で唯一のグローバルエントリーポイントです。

初期化メソッド

メソッド	パラメーター	戻り値	説明
`init(Context)`	context：アプリケーションコンテキスト	void	グローバル設定を初期化します。このメソッドは Application.onCreate() で呼び出します。

ステータスクエリ

メソッド	パラメーター	戻り値	説明
`isInitialized()`	-	boolean	初期化が完了したかどうかを確認します。
`getContext()`	-	Context	アプリケーションコンテキストを取得します。
`getPlayerKitVersion()`	-	String	キットのバージョン番号を取得します。
`getSdkVersion()`	-	String	基盤となる SDK のバージョン番号を取得します。
`getDeviceId()`	-	String	デバイス ID を取得します。

構成メソッド

メソッド	パラメーター	戻り値	説明
`setDebugModeEnabled(boolean)`	enable：特徴を有効にするかどうかを指定します。	void	デバッグモードを有効または無効にします。
`isDebugModeEnabled()`	-	boolean	デバッグモードが有効かどうかを確認します。
`setLogPanelEnabled(boolean)`	enable：有効にするには true に設定します	void	ログパネルを表示または非表示にします。
`isLogPanelEnabled()`	-	boolean	ログパネルが有効かどうかを確認します。
`setDisableScreenshot(boolean)`	disable：特徴を無効にするかどうかを指定します。	void	スナップショットを有効または無効にします。
`isDisableScreenshot()`	-	boolean	スナップショットが無効かどうかを確認します。
`setPlayerViewType(PlayerViewType)`	viewType：ビュータイプ	void	プレーヤービュータイプを設定します。
`getPlayerViewType()`	-	PlayerViewType	現在のプレーヤービュータイプを取得します。

キャッシュ管理

メソッド	パラメーター	戻り値	説明
`clearCaches()`	-	void	プレーヤーのキャッシュをクリアします。

グローバル API

メソッド	パラメーター	戻り値	説明
`getLogger()`	-	IPlayerLogger	グローバルロガーインスタンスを取得します。
`getPreloader()`	-	IPlayerPreloader	グローバルプリローダーインスタンスを取得します。
`setLogger(IPlayerLogger)`	logger：ロガーインスタンス	void	カスタムロガー実装を設定します。
`setPreloader(IPlayerPreloader)`	preloader：プリローダーインスタンス	void	カスタムプリローダー実装を設定します。

AliPlayerView (ビューコンポーネント)

AliPlayerView クラスは、コアプレーヤーのビューコンポーネントです。UI レンダリングとスロット管理を処理します。MVC アーキテクチャのビューレイヤーとして、プレーヤー UI をレンダリングし、UI コンポーネントを管理します。

コントローラーのバインド

メソッド	パラメーター	戻り値	説明
`attach(AliPlayerController, AliPlayerModel)`	controller, model	void	デフォルト UI を使用してコントローラーとデータをバインドします。
`attach(AliPlayerController, AliPlayerModel, SlotRegistry)`	controller, model, registry	void	カスタム UI を使用してコントローラーとデータをバインドします。
`detach()`	-	void	バインドを解除し、リソースを解放します。

ライフサイクル

メソッド	パラメーター	戻り値	説明
`bindLifecycle(LifecycleOwner)`	lifecycleOwner	boolean	ライフサイクルをバインドします。

その他のメソッド

メソッド	パラメーター	戻り値	説明
`onBackPressed()`	-	boolean	戻るボタンの押下を処理します。処理された場合は true を返します。
`getSlotManager()`	-	ISlotManager	スロットマネージャーを取得します。

AliPlayerController (コントローラー)

AliPlayerController クラスは、再生ロジックと状態管理をコントロールします。MVC アーキテクチャのコントローラーレイヤーとして、ビューレイヤーとモデルレイヤー間のインタラクションを調整します。

コンストラクター

メソッド	パラメーター	説明
`AliPlayerController(Context)`	context：アプリケーションコンテキスト	デフォルトのライフサイクルポリシーを使用してコントローラーを作成します。
`AliPlayerController(Context, IPlayerLifecycleStrategy)`	context, lifecycleStrategy	カスタムのライフサイクルポリシーを使用してコントローラーを作成します。

構成と初期化

メソッド	パラメーター	戻り値	説明
`configure(AliPlayerModel)`	model：再生データ	void	再生データを構成します。
`getModel()`	-	AliPlayerModel	現在の再生データ構成を取得します。
`getPlayer()`	-	IMediaPlayer	プレーヤーインスタンスを取得します。
`destroy()`	-	void	プレーヤーを削除します。

状態管理

メソッド	パラメーター	戻り値	説明
`getStateStore()`	-	IPlayerStateStore	プレーヤー状態ストアを取得します。
`getStrategyManager()`	-	StrategyManager	ストラテジーマネージャーを取得します。

ビュー設定

メソッド	パラメーター	戻り値	説明
`setDisplayView(AliDisplayView)`	displayView	void	ディスプレイビューを設定します。
`setSurface(Surface)`	surface	void	Surface を設定します。
`surfaceChanged()`	-	void	Surface が変更されたことを通知します。

ライフサイクルメソッド

メソッド	パラメーター	戻り値	説明
`onResume()`	-	void	LifecycleOwner コンテキスト外で手動で再生を再開します。
`onPause()`	-	void	LifecycleOwner コンテキスト外で手動で再生を一時停止します。

AliPlayerModel (データモデル)

AliPlayerModel クラスは、再生構成データをカプセル化します。MVC アーキテクチャのモデルレイヤーとして、プレーヤーに必要なすべての構成データを保持します。インスタンスの作成にはビルダーパターンを使用します。

ビルダーメソッド

メソッド	パラメーター	説明
`videoSource(VideoSource)`	ビデオソースオブジェクト	ビデオソースを設定します。必須です。
`sceneType(int)`	シーンタイプ	再生シーンタイプを設定します。
`coverUrl(String)`	サムネイル URL	サムネイル URL を設定します。
`videoTitle(String)`	ビデオタイトル	ビデオタイトルを設定します。
`autoPlay(boolean)`	自動再生	自動再生を有効にするかどうかを設定します。
`traceId(String)`	トレース ID	トレース ID を設定します。
`startTime(long)`	開始位置	開始位置をミリ秒単位で設定します。
`isHardWareDecode(boolean)`	ハードウェアデコードが有効か？	ハードウェアデコードを有効にするかどうかを設定します。
`allowedScreenSleep(boolean)`	休止状態はサポートされているか？	画面スリープを許可するかどうかを設定します。
`build()`	-	AliPlayerModel インスタンスをビルドします。

プロパティアクセサー

メソッド	戻り値	説明
`getVideoSource()`	VideoSource	ビデオソースオブジェクトを取得します。
`getSceneType()`	int	再生シーンタイプを取得します。
`getCoverUrl()`	String	サムネイル URL を取得します。
`getVideoTitle()`	String	ビデオタイトルを取得します。
`isAutoPlay()`	boolean	自動再生が有効かどうかを取得します。
`getTraceId()`	String	トレース ID を取得します。
`getStartTime()`	long	開始位置を取得します。
`isHardWareDecode()`	boolean	ハードウェアデコードが有効かどうかを取得します。
`isAllowedScreenSleep()`	boolean	画面スリープが許可されているかどうかを取得します。

スロットシステム

スロットシステムは、AliPlayerKit の UI 拡張メカニズムです。これにより、プレーヤーの個々の UI コンポーネントをカスタマイズできます。

ISlotManager (スロット管理インターフェイス)

ISlotManager インターフェイスは、スロット管理機能を提供します。AliPlayerView.getSlotManager() から取得します。

メソッド	パラメーター	戻り値	説明
`rebuildSlots()`	-	void	SlotRegistry を変更した後、すべてのスロットを再ビルドします。
`getSlotView(SlotType)`	slotType：スロットタイプ	View	指定されたタイプのスロットビューを取得します。
`bindData(AliPlayerModel)`	model：再生データ	void	再生データをスロットシステムにバインドします。
`unbindData()`	-	void	再生データのバインドを解除します。
`updateSceneType(int)`	sceneType：シーンタイプ	void	シーンタイプを更新し、スロットを再ビルドします。

SlotRegistry (スロットレジストリ)

SlotRegistry クラスは、カスタムスロットを登録します。これを AliPlayerView.attach() に渡します。

登録メソッド

メソッド	パラメーター	説明
`register(SlotType, SlotBuilder)`	type, builder	スロットビルダーを登録します。
`register(SlotType, Class<? extends View>)`	type, slotClass	スロットクラスを登録します。クラスはリフレクションを使用して作成されます。
`register(SlotType, int)`	type, layoutId	レイアウトリソースをスロットとして登録します。

管理メソッド

メソッド	戻り値	説明
`unregister(SlotType)`	SlotBuilder	スロットビルダーの登録を解除します。
`isRegistered(SlotType)`	boolean	登録されているかどうかを確認できます。
`clear()`	void	すべての登録をクリアします。
`size()`	int	登録されているスロットの数を取得します。

ISlot (スロットインターフェイス)

カスタムスロットは、そのライフサイクルを定義するために ISlot インターフェイスを実装する必要があります。

メソッド	説明
`onAttach(SlotHost)`	スロットがホストにアタッチされたときに呼び出されます。
`onDetach()`	スロットがホストからデタッチされたときに呼び出されます。
`onBindData(AliPlayerModel)`	再生データがバインドされたときに呼び出されます。
`onUnbindData()`	再生データのバインドが解除されたときに呼び出されます。

説明

カスタムスロットを実装するには、BaseSlot を拡張することを推奨します。フレームワークはイベントサブスクリプションのライフサイクルを自動的に管理します。

SlotType (スロットタイプ)

定数	説明
`SlotType.PLAYER_SURFACE`	プレーヤーサーフェスビュースロット：ビデオコンテンツのレンダリングに使用されるコアビューです。
`SlotType.FULLSCREEN`	フルスクリーン管理スロット：フルスクリーン切り替えロジックを管理します。
`SlotType.GESTURE_CONTROL`	ジェスチャーコントロールスロット：タップ、ダブルタップ、長押し、ドラッグなどのジェスチャーコントロールを処理します。
`SlotType.LANDSCAPE_HINT`	横向き視聴ヒントスロット：ユーザーに横向きビデオをフルスクリーンで視聴するように促します。
`SlotType.COVER`	カバー画像スロット：ビデオのカバー画像を表示します。
`SlotType.CENTER_DISPLAY`	中央表示スロット：再生速度、輝度、ボリュームなど、中央エリアにステータス情報を表示します。
`SlotType.PLAY_STATE`	再生状態スロット：エラーメッセージや読み込みインジケーターなどの再生状態情報を表示します。
`SlotType.LOG_PANEL`	ログパネルスロット：デバッグ用にプレーヤーのログ情報を表示します。
`SlotType.TOP_BAR`	上部コントロールバー：戻るボタン、タイトル、設定を表示します。
`SlotType.BOTTOM_BAR`	下部コントロールバー：再生コントロール、プログレスバー、フルスクリーン切り替えを表示します。
`SlotType.SETTING_MENU`	設定メニュースロット：再生速度、解像度、ミラーリング、回転オプションなどの設定メニューを表示します。

SceneType (再生シーン)

定数	値	説明
`SceneType.VOD`	0	ビデオオンデマンドシーン：完全な再生コントロールを備えた標準的なビデオ再生です。
`SceneType.LIVE`	1	ライブストリーミングシーン：シークや速度制御のないリアルタイムストリーム再生です。
`SceneType.VIDEO_LIST`	2	ビデオリストシーン：ビデオリストで使用されるプレーヤーです。垂直ジェスチャーを無効にします。
`SceneType.RESTRICTED`	3	制限付き再生シーン：タイムライン操作を制限します。教育やトレーニングで使用されます。
`SceneType.MINIMAL`	4	最小限の再生シーン：UI 要素なしで再生ビューのみを表示します。

PlayerViewType (プレーヤービュータイプ)

定数	説明
`PlayerViewType.DISPLAY_VIEW`	AliDisplayView (推奨)：互換性とパフォーマンスが向上した公式のディスプレイビューコンポーネントです。
`PlayerViewType.SURFACE_VIEW`	SurfaceView：独立したレンダリングスレッドを使用しますが、アニメーションはサポートしていません。
`PlayerViewType.TEXTURE_VIEW`	TextureView：アニメーションと変換をサポートします。ビューアニメーションが必要なシーンに最適です。

ビデオソース

VideoSourceFactory (ビデオソースファクトリ)

メソッド	パラメーター	戻り値	説明
`VideoSourceFactory.createVidAuthSource(String, String)`	vid, playAuth	VideoSource	VidAuth ビデオソースを作成します (推奨)。
`VideoSourceFactory.createVidStsSource(String, String, String, String, String)`	vid, accessKeyId, accessKeySecret, securityToken, region	VideoSource	VidSts ビデオソースを作成します。
`VideoSourceFactory.createUrlSource(String)`	url：ビデオ URL	VideoSource	URL ビデオソースを作成します。

VideoSource (ビデオソース)

メソッド	戻り値	説明
`isValid()`	boolean	ビデオソースが有効かどうかを確認します。
`getType()`	int	ビデオソースタイプを取得します。
`getSourceId()`	String	ビデオソース ID を取得します。

プレーヤーインターフェイス

IMediaPlayer (メディアプレーヤーインターフェイス)

IMediaPlayer インターフェイスは、コアプレーヤーの操作を定義します。AliPlayerController.getPlayer() から取得します。

再生コントロール

メソッド	パラメーター	説明
`start()`	-	再生を開始します。
`pause()`	-	再生を一時停止します。
`toggle()`	-	再生と一時停止を切り替えます。
`stop()`	-	再生を停止します。
`replay()`	-	ビデオをリプレイします。
`seekTo(long)`	positionMs	指定された位置 (ミリ秒) にシークします。
`release()`	-	プレーヤーリソースを解放します。

データソース

メソッド	パラメーター	説明
`setDataSource(AliPlayerModel)`	model	ビデオデータソースを設定します。

ビュー設定

メソッド	パラメーター	説明
`setDisplayView(AliDisplayView)`	displayView	ディスプレイビューを設定します。
`setSurface(Surface)`	surface	レンダリング Surface を設定します。
`surfaceChanged()`	-	Surface が変更されたことを通知します。

再生設定

メソッド	パラメーター	説明
`setSpeed(float)`	speed	再生速度を設定します (0.3 から 3.0)。
`setLoop(boolean)`	loop	ループ再生を有効または無効にします。
`setMute(boolean)`	mute	ミュートします。
`setScaleType(int)`	scaleType	レンダリングフィルモードを設定します。
`setMirrorType(int)`	mirrorType	ミラーリングモードを設定します。
`setRotation(int)`	rotation	回転角度を設定します。
`selectTrack(TrackQuality)`	trackQuality	ビデオ解像度を選択します。
`snapshot()`	-	スナップショットをキャプチャします。

状態クエリ

メソッド	戻り値	説明
`getPlayerId()`	String	一意のプレーヤー識別子を取得します。
`getStateStore()`	IPlayerStateStore	状態ストアインターフェイスを取得します。

ScaleType (レンダリングフィルモード)

定数	値	説明
`ScaleType.FIT_XY`	0	ビューに合わせて引き伸ばして埋めます。
`ScaleType.FIT_CENTER`	1	アスペクト比を維持してフィットさせます (黒枠が表示される場合があります)。
`ScaleType.CENTER_CROP`	2	アスペクト比を維持しながらクロップして埋めます。

MirrorType (ミラーリングモード)

定数	値	説明
`MirrorType.NONE`	0	ミラーリングなし。
`MirrorType.HORIZONTAL`	1	水平ミラーリング。
`MirrorType.VERTICAL`	2	垂直ミラーリング。

Rotation (回転角度)

定数	値	説明
`Rotation.DEGREE_0`	0	0 度。
`Rotation.DEGREE_90`	90	90 度。
`Rotation.DEGREE_180`	180	180 度。
`Rotation.DEGREE_270`	270	270 度。

状態ストレージインターフェイス

IPlayerStateStore (プレーヤー状態ストレージ)

IPlayerStateStore インターフェイスは、プレーヤーの状態への読み取り専用アクセスを提供します。AliPlayerController.getStateStore() または IMediaPlayer.getStateStore() から取得します。

再生状態

メソッド	戻り値	説明
`getPlayState()`	PlayerState	現在の再生状態を取得します。
`getDuration()`	long	ビデオの総再生時間 (ミリ秒) を取得します。
`getCurrentPosition()`	long	現在の再生位置 (ミリ秒) を取得します。
`getCurrentSpeed()`	float	現在の再生速度を取得します。

ビデオ設定

メソッド	戻り値	説明
`getVideoSize()`	VideoSize	ビデオサイズを取得します (null の場合があります)。
`getCurrentRotation()`	int	現在の回転角度を取得します。
`getCurrentScaleType()`	int	現在のフィルモードを取得します。
`getCurrentMirrorType()`	int	現在のミラーリングモードを取得します。

再生設定

メソッド	戻り値	説明
`isLoop()`	boolean	ループ再生が有効かどうかを確認します。
`isMute()`	boolean	音声がミュートされているかどうかを確認します。
`isFullscreen()`	boolean	プレーヤーがフルスクリーンモードかどうかを確認します。

定義

メソッド	戻り値	説明
`getTrackQualityList()`	List	利用可能な定義のリストを取得します。
`getCurrentTrackIndex()`	int	現在の定義のインデックスを取得します。

PlayerState (再生状態)

定数	説明
`PlayerState.UNKNOWN`	不明な状態：プレーヤーの状態が不明または未初期化です。
`PlayerState.IDLE`	アイドル状態：プレーヤーは作成されていますが、まだ初期化されていないか、リソースが解放されています。
`PlayerState.INITIALIZING`	初期化中：プレーヤーは初期化中で、ビデオソースのロードを準備しています。
`PlayerState.INITIALIZED`	初期化済み：プレーヤーは完全に初期化されていますが、まだ再生準備ができていません。
`PlayerState.PREPARING`	準備中：プレーヤーはビデオソースを準備し、ビデオ情報を解析しています。
`PlayerState.PREPARED`	準備完了：プレーヤーは再生を開始する準備ができています。
`PlayerState.PLAYING`	再生中：プレーヤーはビデオをアクティブに再生しています。
`PlayerState.PAUSED`	一時停止中：プレーヤーは一時停止しています。
`PlayerState.COMPLETED`	完了：ビデオの再生が終了しました。
`PlayerState.STOPPED`	停止：プレーヤーは停止しています。
`PlayerState.ERROR`	エラー：再生中にエラーが発生しました。

イベントシステム

PlayerEventBus (イベントバス)

PlayerEventBus クラスは、プレーヤーイベントを公開およびサブスクライブするためのグローバルイベントバスです。

サブスクリプションメソッド

メソッド	パラメーター	説明
`subscribe(Class<T>, EventListener<T>)`	eventType, listener	指定されたタイプのイベントをサブスクライブします。
`unsubscribe(Class<T>, EventListener<T>)`	eventType, listener	指定されたタイプのイベントのサブスクリプションを解除します。
`unsubscribe(EventListener<?>)`	listener	すべてのイベントタイプからリスナーのサブスクリプションを解除します。
`unsubscribeAll()`	-	すべてのサブスクリプションをクリアします。注意して使用してください。

公開メソッド

メソッド	パラメーター	説明
`post(PlayerEvent)`	event	イベントを公開します。

クエリメソッド

メソッド	戻り値	説明
`getSubscriberCount(Class<?>)`	int	指定されたイベントタイプのサブスクライバー数を取得します。
`hasSubscribers(Class<?>)`	boolean	指定されたイベントタイプにサブスクライバーが存在するかどうかを確認します。

PlayerCommand (プレーヤーコマンド)

プレーヤーコマンドはプレーヤーの動作をコントロールします。PlayerEventBus.post() を使用して公開します。

コマンドクラス	パラメーター	説明
`PlayerCommand.Play`	playerId	再生コマンド。
`PlayerCommand.Pause`	playerId	一時停止コマンド。
`PlayerCommand.Toggle`	playerId	再生と一時停止を切り替えます。
`PlayerCommand.Stop`	playerId	停止コマンド。
`PlayerCommand.Replay`	playerId	リプレイコマンド。
`PlayerCommand.Seek`	playerId, position	シークコマンド。位置はミリ秒単位です。
`PlayerCommand.SetSpeed`	playerId, speed	再生速度を設定します (0.3 から 3.0)。
`PlayerCommand.Snapshot`	playerId	スクリーンショットコマンド。
`PlayerCommand.SetLoop`	playerId, loop	ループ再生を設定します。
`PlayerCommand.SetMute`	playerId, mute	ミュートを設定します。
`PlayerCommand.SetScaleType`	playerId, scaleType	レンダリングフィルモードを設定します。
`PlayerCommand.SetMirrorType`	playerId, mirrorType	ミラーリングモードを設定します。
`PlayerCommand.SetRotation`	playerId, rotation	回転角度を設定します。
`PlayerCommand.SelectTrack`	playerId, trackQuality	解像度を切り替えることができます。

使用例

// 再生コマンドを投稿します。
PlayerEventBus.getInstance().post(new PlayerCommand.Play(playerId));

// シークコマンドを投稿します。
PlayerEventBus.getInstance().post(new PlayerCommand.Seek(playerId, 5000));

// 再生速度を設定します。
PlayerEventBus.getInstance().post(new PlayerCommand.SetSpeed(playerId, 1.5f));

PlayerEvents (プレーヤーイベント)

プレーヤーの状態変更はイベントとして公開されます。サブスクライブしてリッスンします。

イベントクラス	プロパティ	説明
`PlayerEvents.StateChanged`	oldState, newState	再生状態が変更されました。
`PlayerEvents.Prepared`	duration	プレーヤーの準備が完了しました。
`PlayerEvents.FirstFrameRendered`	-	最初のフレームがレンダリングされました。
`PlayerEvents.VideoSizeChanged`	width, height	ビデオサイズが変更されました。
`PlayerEvents.Info`	duration, currentPosition, bufferedPosition	再生情報が更新されました。
`PlayerEvents.Error`	errorCode, errorMsg	エラーイベント。
`PlayerEvents.LoadingBegin`	-	読み込みが開始されました。
`PlayerEvents.LoadingProgress`	percent, netSpeed	読み込みの進行状況。
`PlayerEvents.LoadingEnd`	-	読み込みが終了しました。
`PlayerEvents.SetSpeedCompleted`	speed	速度設定が完了しました。
`PlayerEvents.SnapshotCompleted`	result, snapshotPath, width, height	スナップショットが完了しました。
`PlayerEvents.SetLoopCompleted`	loop	ループ設定が完了しました。
`PlayerEvents.SetMuteCompleted`	mute	ミュート設定が完了しました。
`PlayerEvents.SetScaleTypeCompleted`	scaleType	フィルモード設定が完了しました。
`PlayerEvents.SetMirrorTypeCompleted`	mirrorType	ミラーリング設定が完了しました。
`PlayerEvents.SetRotationCompleted`	rotation	回転設定が完了しました。
`PlayerEvents.TrackQualityListUpdated`	trackQualityList	定義リストが更新されました。
`PlayerEvents.TrackSelected`	trackIndex	定義の選択が完了しました。

使用例

// 再生イベントをサブスクライブします。
PlayerEventBus.getInstance().subscribe(PlayerEvents.Prepared.class, event -> {
    long duration = event.duration;  // ビデオの総再生時間
});

// エラーイベントをサブスクライブします。
PlayerEventBus.getInstance().subscribe(PlayerEvents.Error.class, event -> {
    int code = event.errorCode;
    String msg = event.errorMsg;
});

ロギングシステム

IPlayerLogger (ロギングインターフェイス)

IPlayerLogger インターフェイスは、グローバルなロギング構成を提供します。AliPlayerKit.getLogger() から取得します。

メソッド	パラメーター	戻り値	説明
`enableConsoleLog(boolean)`	enable	void	コンソールロギングを有効または無効にします。
`isConsoleLogEnabled()`	-	boolean	コンソールロギングが有効かどうかを確認します。
`setLogLevel(int)`	level	void	ログレベルを設定します。
`getLogLevel()`	-	int	現在のログレベルを取得します。
`setLogCallback(LoggerCallback)`	callback	void	ログコールバックリスナーを設定します。

LogLevel (ログレベル)

定数	値	説明
`LogLevel.VERBOSE`	0	最も詳細なレベル。すべてのデバッグ情報をログに記録します。
`LogLevel.DEBUG`	1	デバッグレベル。
`LogLevel.INFO`	2	情報レベル。
`LogLevel.WARN`	3	警告レベル。
`LogLevel.ERROR`	4	エラーレベル。
`LogLevel.NONE`	100	すべてのログを無効にします。

プリロードインターフェイス

IPlayerPreloader (プリロードインターフェイス)

IPlayerPreloader インターフェイスは、グローバルなプリロード管理を提供します。AliPlayerKit.getPreloader() から取得します。

メソッド	パラメーター	戻り値	説明
`addTask(PlayerPreloadTask, PreloadCallback)`	task, listener	String	プリロードタスクを追加し、その ID を返します。
`cancelTask(String)`	taskId	void	指定されたタスクをキャンセルします。
`pauseTask(String)`	taskId	void	指定されたタスクを一時停止します。
`resumeTask(String)`	taskId	void	指定されたタスクを再開します。

PreloadCallback (プリロードコールバック)

メソッド	パラメーター	説明
`onCompleted(String, VideoSource)`	taskId, source	プリロードが完了しました。
`onError(String, VideoSource, int, String)`	taskId, source, code, message	プリロードエラー。
`onCanceled(String, VideoSource)`	taskId, source	プリロードがキャンセルされました。

プレーヤーライフサイクルポリシー

IPlayerLifecycleStrategy (プレーヤーライフサイクルポリシーインターフェイス)

IPlayerLifecycleStrategy インターフェイスは、プレーヤーインスタンスがライフサイクル全体でどのように管理されるかを定義します。プレーヤーインスタンスの作成と再利用を最適化します。

メソッド	パラメーター	戻り値	説明
`init(IPlayerFactory)`	factory	void	ポリシーを初期化します。
`acquire(Context, String)`	context, uniqueId	IMediaPlayer	プレーヤーインスタンスを取得します。
`recycle(IMediaPlayer, String, boolean)`	player, uniqueId, force	void	プレーヤーインスタンスをリサイクルします。
`clear()`	-	void	すべてのリソースをクリアします。
`preload(Context, int)`	context, count	void	プレーヤーインスタンスをプリロードします。

組み込みポリシー

ポリシークラス	説明
`DefaultLifecycleStrategy`	デフォルトポリシー：毎回新しいインスタンスを作成し、使用後すぐに削除します。
`ReusePoolLifecycleStrategy`	再利用プールポリシー：ビデオのストリーミングリストに最適です。
`IdScopedPoolLifecycleStrategy`	ID スコープポリシー：1 つのインスタンスを 1 つの ID にバインドします。
`SingletonLifecycleStrategy`	シングルトンポリシー：グローバルインスタンスは 1 つだけです。

詳細については、「プレーヤーライフサイクルポリシー」をご参照ください。

ストラテジーシステム

StrategyManager (ストラテジーマネージャー)

StrategyManager クラスは、すべてのストラテジーのライフサイクルを管理します。AliPlayerController.getStrategyManager() から取得します。

メソッド	パラメーター	戻り値	説明
`register(IStrategy)`	strategy	void	ストラテジーを登録します。
`unregister(IStrategy)`	strategy	void	ポリシーの登録解除
`getStrategy(String)`	name	IStrategy	名前でストラテジーを取得します。
`start(StrategyContext)`	context	void	すべてのストラテジーを開始します。
`stop()`	-	void	すべてのストラテジーを停止します。
`reset()`	-	void	すべてのストラテジーをリセットします。
`updateContext(StrategyContext)`	context	void	コンテキストを更新し、ストラテジーを再起動します。
`destroy()`	-	void	マネージャーを削除します
`getStrategyCount()`	-	int	登録されているストラテジーの数を取得します。
`isStarted()`	-	boolean	開始されたかどうかを確認できます。

IStrategy (ストラテジーインターフェイス)

メソッド	説明
`getName()`	ストラテジー名を取得します。
`onStart(StrategyContext)`	ストラテジーが開始されるときに呼び出されます。
`onStop()`	ストラテジーが停止するときに呼び出されます。
`onReset()`	ストラテジーがリセットされるときに呼び出されます。