tencent cloud

Video on Demand

릴리스 노트 및 공지 사항
릴리스 노트
제품 소개
제품 개요
Product Features
제품 기능
제품 장점
시나리오
솔루션
구매 가이드
과금 개요
과금 방식
구매 가이드
청구서 조회
연장 안내
연체 안내
환불 안내
시작하기
콘솔 가이드
콘솔 소개
서비스 개요
애플리케이션 관리
미디어 관리
리소스 패키지 관리
License Management
사례 튜토리얼
미디어 업로드
VOD 미디어 파일을 스마트 콜드 스토리지하는 방법
비디오 처리
배포 및 재생
이벤트 알림 수신 방법
원본 서버 마이그레이션 방법
라이브 방송 녹화
사용자 지정 Origin-pull을 수행하는 방법
라이브 방송 하이라이트 클리핑을 VOD에 통합하기 위한 가이드
EdgeOne을 사용하여 VOD 콘텐츠 배포하는 방법
개발 가이드
미디어 업로드
미디어 처리
비디오 AI
이벤트 알림
비디오 재생
미디어 파일 다운로드
서브 애플리케이션 시스템
오류 코드
플레이어 SDK 문서
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
FAQs
모바일 재생
요금
비디오 업로드
비디오 배포
비디오 재생
Web 재생
전체 화면 재생
데이터 통계
액세스 관리
미디어 자산 콜드 스토리지
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.

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백