com.aliyun.loader

Class MediaLoaderV2

java.lang.Object

com.aliyun.loader.MediaLoaderV2

public class MediaLoaderV2
extends java.lang.Object

A manager for media preloading. This class provides capabilities for submitting, controlling (canceling, pausing, resuming), and listening to the status of preload tasks. It is a singleton, and the global instance should be obtained via getInstance().

Method Summary

Modifier and Type	Method and Description
java.lang.String	addTask(PreloadTask preloadTask, OnPreloadListener listener) Submits a new preload task and associates it with a status callback listener.
void	cancelTask(java.lang.String taskId) Cancels the specified preload task.
static MediaLoaderV2	getInstance() Gets the global singleton instance of MediaLoaderV2.
static void	loadClass()
void	pauseTask(java.lang.String taskId) Pauses the specified preload task.
void	resumeTask(java.lang.String taskId) Resumes a paused preload task.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

loadClass

public static void loadClass()

getInstance

public static MediaLoaderV2 getInstance()

Gets the global singleton instance of MediaLoaderV2.

Returns:

The unique instance of MediaLoaderV2.

addTask

public java.lang.String addTask(PreloadTask preloadTask,
                                OnPreloadListener listener)

Submits a new preload task and associates it with a status callback listener. Status changes for the task will be notified through the provided listener. Each time a task is submitted, the system generates a unique task ID (taskId). Even if the same task configuration is submitted multiple times, the corresponding task IDs will still be different. Multiple tasks added are executed in parallel with no priority order.

Parameters:

preloadTask - The configuration object for the preload task, containing data source, loading duration, and other info. See PreloadTask.

listener - The callback listener to receive status updates for this task. See OnPreloadListener.

Returns:

A unique task ID (taskId). This ID is used for subsequent control of the task.

cancelTask

public void cancelTask(java.lang.String taskId)

Cancels the specified preload task. This operation stops the loading of the unfinished parts of the task but does not delete any already downloaded local cache files.

Parameters:

taskId - The ID of the task to cancel, returned by the addTask(PreloadTask, OnPreloadListener) method.

pauseTask

public void pauseTask(java.lang.String taskId)

Pauses the specified preload task.

Parameters:

taskId - The ID of the task to pause, returned by the addTask(PreloadTask, OnPreloadListener) method.

resumeTask

public void resumeTask(java.lang.String taskId)

Resumes a paused preload task.

Parameters:

taskId - The ID of the task to resume, returned by the addTask(PreloadTask, OnPreloadListener) method.