com.aliyun.loader

Class MediaLoader

java.lang.Object

com.aliyun.loader.MediaLoader

public class MediaLoader
extends java.lang.Object

A loader for pre-caching video file content. This class is designed to improve playback startup speed and reduce buffering by pre-loading parts of a video into a local cache. It is a singleton, and the global instance should be obtained via getInstance(). Loading tasks are performed asynchronously, and status updates are delivered through the MediaLoader.OnLoadStatusListener.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	MediaLoader.OnLoadStatusListener A listener for receiving loading status updates.

Field Summary

Fields

Modifier and Type	Field and Description
static int	OLD_CODE_EADDED
static int	OLD_CODE_ENOT_ENABLE

Method Summary

Modifier and Type	Method and Description
void	cancel(java.lang.String url) Cancels one or all loading tasks.
static MediaLoader	getInstance() Gets the global singleton instance of MediaLoader.
void	load(java.lang.String url, long duration) Asynchronously starts loading the specified video file.
void	load(java.lang.String url, long duration, int bandwidth) Asynchronously starts loading the specified video file with a preferred bitrate.
static void	loadClass()
void	loadWithResolution(java.lang.String url, long duration, int resolutionProduct) Asynchronously starts loading the specified video file with a preferred resolution.
void	pause(java.lang.String url) Pauses one or all loading tasks.
void	resume(java.lang.String url) Resumes one or all paused loading tasks.
void	setOnLoadStatusListener(MediaLoader.OnLoadStatusListener listener) Sets the listener for loading status updates.

Methods inherited from class java.lang.Object

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

Field Detail

OLD_CODE_EADDED

public static final int OLD_CODE_EADDED

See Also:

Constant Field Values

OLD_CODE_ENOT_ENABLE

public static final int OLD_CODE_ENOT_ENABLE

See Also:

Constant Field Values

Method Detail

loadClass

public static void loadClass()

getInstance

public static MediaLoader getInstance()

Gets the global singleton instance of MediaLoader.

Returns:

The unique instance of MediaLoader.

load

public void load(java.lang.String url,
                 long duration)

Asynchronously starts loading the specified video file. This method pre-loads content for the specified `duration`. It is possible to initiate loading tasks for multiple different URLs simultaneously. For multi-bitrate HLS streams, this method loads a default stream. To specify a bitrate or resolution, use other overloaded methods.

Parameters:

url - The URL of the video file to load.

duration - The duration of the content to preload, in milliseconds.

See Also:

load(String, long, int), loadWithResolution(String, long, int)

load

public void load(java.lang.String url,
                 long duration,
                 int bandwidth)

Asynchronously starts loading the specified video file with a preferred bitrate. This method is primarily used for multi-bitrate HLS streams. The loader will select the stream with a bitrate closest to the specified `bandwidth` for pre-loading. It is possible to initiate loading tasks for multiple different URLs simultaneously.

Parameters:

url - The URL of the video file to load.

duration - The duration of the content to preload, in milliseconds.

bandwidth - The desired bitrate in bps (bits per second). The loader will select the stream closest to this value.

loadWithResolution

public void loadWithResolution(java.lang.String url,
                               long duration,
                               int resolutionProduct)

Asynchronously starts loading the specified video file with a preferred resolution. This method is primarily used for multi-bitrate HLS streams. The loader will select the stream with a resolution closest to the specified `resolutionProduct` for pre-loading. It is possible to initiate loading tasks for multiple different URLs simultaneously. For example, to pre-load a 1080P (1920x1080) stream, you can pass in 2073600 (1920 * 1080).

Parameters:

url - The URL of the video file to load.

duration - The duration of the content to preload, in milliseconds.

resolutionProduct - The product of the width and height of the desired resolution. The loader will select the stream closest to this value.

cancel

public void cancel(java.lang.String url)

Cancels one or all loading tasks. If `url` is not null or empty, it cancels the loading task for the corresponding URL. If `url` is null or empty, all ongoing loading tasks are canceled. Note: This operation does not delete any already downloaded cache files.

Parameters:

url - The URL of the video file to cancel loading. Pass null or an empty string to cancel all tasks.

pause

public void pause(java.lang.String url)

Pauses one or all loading tasks.

Parameters:

url - The URL of the video file to pause loading. Pass null or an empty string to pause all tasks.

resume

public void resume(java.lang.String url)

Resumes one or all paused loading tasks.

Parameters:

url - The URL of the video file to resume loading. Pass null or an empty string to resume all tasks.

setOnLoadStatusListener

public void setOnLoadStatusListener(MediaLoader.OnLoadStatusListener listener)

Sets the listener for loading status updates.

Parameters:

listener - An instance of the listener for loading status callbacks. See MediaLoader.OnLoadStatusListener.