tencent cloud

Video on Demand

動向とお知らせ
製品アップデート情報
製品紹介
製品概要
Product Features
製品の機能
製品の強み
ユースケース
ソリューション
購入ガイド
課金概要
課金方式
購入ガイドライン
請求書の照会
支払い更新の説明
支払い延滞の説明
返金説明
クイックスタート
コンソールガイド
コンソールの説明
サービスの概要
アプリケーション管理
メディア管理
リソースパック管理
License Management
プラクティスチュートリアル
メディアのアップロード
オンデマンドメディアファイルのインテリジェントコールド化方法
ビデオ処理
配信と再生
イベント通知の受信方法
オリジンサーバーのマイグレーションツール
Live Recording
カスタムオリジンサーバーback-to-originの方法
ライブストリーミングハイライトクリップを VOD に永続化するためのガイド
EdgeOne を使用して VOD コンテンツを配信する方法
開発ガイド
メディアアップロード
メディア加工処理
ビデオAI
イベント通知
ビデオ再生
メディアファイルのダウンロード
サブアプリケーションシステム
エラーコード
Player+ドキュメント
Overview
Basic Concepts
Features
Free Demo
Free Trial License
Purchase Guide
SDK Download
Licenses
Player Guide
Integration (UI Included)
Integration (No UI)
Advanced Features
API Documentation
Player Adapter
Player SDK Policy
よくあるご質問
モバイル端末再生に関するご質問
料金
ビデオのアップロード
ビデオの公開
ビデオの再生
Web側の再生
全画面表示再生
データ統計
CAM関連
メディア資産冷却に関する質問
Agreements
Service Level Agreement
VOD ポリシー
プライバシーポリシー
データ処理とセキュリティ契約
お問い合わせ
用語集

TXVodPreloadManager

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-05-30 15:07:48

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.
Before starting preloading, set the cache directory TXPlayerGlobalSetting#setCacheFolderPath and cache size TXPlayerGlobalSetting#setMaxCacheSize for the playback engine. 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, support through Tencent Cloud fileId and video URL.
If TXPlayInfoParams#getUrl is not null, preferentially start video URL preloading, at this point support calling in the mainline.
If TXPlayInfoParams#getFileId is not null, start video fileId preloading, at this point does not support calling in the mainline.
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. Set the cache directory TXPlayerGlobalSetting#setCacheFolderPath and cache size TXPlayerGlobalSetting#setMaxCacheSize of the playback engine before starting preloading. 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 headers for preloading using TXPlayInfoParams#setHeaders, and set the preferred audio track name for preloading using 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.

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック