tencent cloud

云点播

动态与公告
产品动态
公告
产品简介
产品概述
产品特性
产品功能
产品优势
应用场景
解决方案
专业版
云点播专业版简介
快速入门
控制台指南
开发指南
购买指南
计费概述
计费方式
购买指引
账单查询
续费说明
欠费说明
退费说明
快速入门
控制台指南
控制台介绍
服务概览
应用管理
媒体管理
资源包管理
License 管理
实时日志分析
实践教程
媒体上传
如何将点播的媒体文件进行智能降冷
媒体处理
分发播放
如何接收事件通知
如何进行源站迁移
直播录制
如何进行自定义源站回源
直播精彩剪辑固化至云点播 VOD 指引
如何使用 EdgeOne 分发云点播内容
开发指南
媒体上传
媒体加工处理
媒体 AI
事件通知
媒体分发播放
媒体加密与版权保护
播放频道
访问管理
下载媒体文件
应用体系
错误码
播放器 SDK 文档
概述
基本概念
产品功能
Demo 体验
免费测试
购买指南
SDK 下载
License 指引
播放器教程
含 UI 集成方案
无 UI 集成方案
高级功能
API 文档
第三方播放器插件
Player SDK Policy
服务端 API 文档
History
Introduction
API Category
Other APIs
Media Processing APIs
Parameter Template APIs
Task Management APIs
Media Upload APIs
Media Management APIs
Event Notification Relevant API
Media Categorization APIs
Domain Name Management APIs
Distribution APIs
AI-based Sample Management APIs
Region Management APIs
Data Statistics APIs
Carousel-Related APIs
Just In Time Transcode APIs
No longer recommended APIs
Making API Requests
AI-based image processing APIs
Task Flow APIs
Data Types
Error Codes
Video on Demand API 2024-07-18
常见问题
移动端播放问题
费用相关问题
视频上传问题
视频发布问题
视频播放问题
Web 端播放问题
全屏播放问题
数据统计问题
访问管理相关问题
媒资降冷问题
相关协议
Service Level Agreement
VOD 政策
隐私政策
数据处理和安全协议
联系我们
词汇表
文档云点播播放器 SDK 文档API 文档iOS视频下载(Download)TXVodPreloadManager

TXVodPreloadManager

PDF
聚焦模式
字号
最后更新时间： 2025-05-30 14:15:34

TXVodPreloadManager API 简介

点播播放器预下载接口类。
不需要创建播放器实例，预先下载视频部分内容，使用播放器时，可以加快视频启播速度，提供更好的播放体验。

接口概览

API
描述
获取 TXVodPreloadManager 实例对象，单例模式。
通过 URL 启动预下载。
通过 fileId 或 URL 启动预下载，推荐优先使用此接口。
停止预下载。

接口详情

sharedManager

获取 TXVodPreloadManager 实例对象，单例模式。
+ (instancetype)sharedManager;

startPreload:preloadSize:preferredResolution:delegate:

通过 URL 启动预下载。
注意：启动预下载前，请先设置好播放引擎的缓存目录 +[TXPlayerGlobalSetting setCacheFolderPath] 和缓存大小
+[TXPlayerGlobalSetting setMaxCacheSize:]，这个设置是全局配置需和播放器保持一致，否则会造成播放缓存失效。
- (int)startPreload:(NSString *)requestURL preloadSize:(float)preloadSizeMB preferredResolution:(long)preferredResolution delegate:(id<TXVodPreloadManagerDelegate>)delegate;
参数说明
参数名
类型
描述
requestURL
NSString
预下载的视频 URL。
preloadSizeMB
float
预下载的大小，单位：MB。
preferredResolution
long
期望下载的分辨率，视频宽高的乘积（width * height）。
不支持多分辨率或不需指定时，传-1。
delegate
预下载监听状态回调对象。
返回值
任务 ID，可用这个任务 ID 停止预下载 -[TXVodPreloadManager stopPreload:]。
如果返回-1， 表示此任务 ID 无效。

startPreloadWithModel:preloadSize:preferredResolution:delegate:

启动预下载，支持通过腾讯云 fileId 和视频 URL 预下载。
如果 -[TXPlayerAuthParams url]不为空，则优先启动视频 URL 预下载，此时支持在主线调用。
如果 -[TXPlayerAuthParams fileId]不为空，则启动视频 fileId 预下载，此时不支持在主线调用。
注意：
1. 预下载是耗时操作，请不要在主线程调用，在主线程调用将会抛出非法调用异常。
2. 启动预下载前，请先设置好播放引擎的缓存目录 +[TXPlayerGlobalSetting setCacheFolderPath:]和缓存大小+[TXPlayerGlobalSetting setMaxCacheSize:]，这个设置是全局配置需和播放器保持一致，否则会造成播放缓存失效。
- (int)startPreloadWithModel:(TXPlayerAuthParams *)params preloadSize:(float)preloadSizeMB preferredResolution:(long)preferredResolution delegate:(id<TXVodPreloadManagerDelegate>)delegate;
参数说明
参数名
类型
描述

params



预下载信息。
可通过 -[TXPlayerAuthParams headers] 设置预下载 http 请求头，通过-[TXPlayerAuthParams preferAudioTrack] 设置预下载的音轨名称。
preloadSizeMB
float
预下载的大小，单位：MB。
preferredResolution
long
期望下载的分辨率，视频宽高的乘积（width * height）。
不支持多分辨率或不需指定时，传-1。
delegate
预下载监听状态回调对象。
返回值
任务 ID，可用这个任务 ID 停止预下载 -[TXVodPreloadManager stopPreload:]。
如果返回-1， 表示此任务 ID 无效。

stopPreload:

停止预下载。
- (void)stopPreload:(int)taskID;
参数说明
参数名
类型
描述
taskID
int
任务 ID。ID 从 startPreload 接口返回值得到。
上一篇: TXVodPreloadManagerDelegate（2）下一篇: TXVodSDKEventDef

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈