tencent cloud

Video on Demand

DokumentasiVideo on Demand

TXVodPreloadManager

Unduh
Mode fokus
Ukuran font
Terakhir diperbarui: 2026-10-26 14:43:56
Diterjemahkan & Diperiksa oleh AI

Introducing the TXVodPreloadManager API

On-demand player preload API class
No need to create a player instance. Pre-download partial video content to speed up startup time when using the player, delivering a better playback experience.

API Overview

API
Description
Retrieve the TXVodPreloadManager instance object in singleton mode.
Start preloading through URL.
Start preloading through fileId or URL. Preferentially use this API.
Stop preloading.

API Detail

getInstance

Retrieve the TXVodPreloadManager instance object in singleton mode.
public static TXVodPreloadManager getInstance(Context context)

startPreload:URL

Start preloading through URL.
Note: Before starting preloading, set the playback engine's cache directory TXPlayerGlobalSetting#setCacheFolderPath and cache size TXPlayerGlobalSetting#setMaxCacheSize. This setting is a global configuration and must be consistent with the player; otherwise, it can lead to playback cache failure.
public int startPreload(final String url, final float preloadSizeMB, final long preferredResolution, final ITXVodPreloadListener listener)
Parameter Description
Parameter Name
Type
Description
url
String
Preloaded video URL.
preloadSizeMB
float
Preload size, unit: MB.
preferredResolution
long
Expected download resolution, the product of video width and height (width * height).
Pass -1 when multiple resolutions are not supported or no specification is required.
listener
Preloading listening status callback.
Return Value
task ID, use this task ID to stop preloading TXVodPreloadManager#stopPreload.
If the return value is -1, it means this task ID is invalid.

startPreload:TXPlayInfoParams

Start preloading. Preloading is supported through Tencent Cloud fileId and video URL.
If TXPlayInfoParams#getUrl is not empty, start video URL preloading first.
If TXPlayInfoParams#getFileId is not empty, start video fileId preloading.
Note:
1. Preloading is a time-consuming operation. Do not call it on the main thread; calling it on the main thread will throw an illegal call exception.
2. Before starting preloading, set the playback engine's cache directory TXPlayerGlobalSetting#setCacheFolderPath and cache size TXPlayerGlobalSetting#setMaxCacheSize. This setting is a global configuration and must be consistent with the player; otherwise, it can lead to playback cache failure.
public int startPreload(final TXPlayInfoParams playInfoParams, final float preloadSizeMB, final long preferredResolution,
        final ITXVodFilePreloadListener listener)
Parameter Description
Parameter Name
Type
Description
playInfoParams
TXPlayInfoParams
Download information.
Set the http request header for preloading via TXPlayInfoParams#setHeaders, and set the audio track name for preloading via TXPlayInfoParams#setPreferAudioTrack.
preloadSizeMB
float
Preload size, unit: MB.
preferredResolution
long
Expected download resolution, the product of video width and height (width * height).
Pass -1 when multiple resolutions are not supported or no specification is required.
listener
Preloading listening status callback.
Return Value
task ID, use this task ID to stop preloading TXVodPreloadManager#stopPreload.
If the return value is -1, it means this task ID is invalid.

stopPreload

Stop preloading.
public void stopPreload(int taskID)
Parameter Description
Parameter Name
Type
Description
taskID
int
task ID. The ID is obtained from the return value of TXVodPreloadManager#startPreload.
Topik selanjutnya: 릴리스 노트

Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan

Search
    Enter keywords to search documentation