TXPlayerGlobalSetting

最近更新时间:2025-05-23 17:46:52

我的收藏

TXPlayerGlobalSetting API 简介

点播播放器全局配置。

接口概览

API
描述
设置播放引擎的 Cache 目录。
获取播放引擎的 Cache 目录。
设置播放引擎的最大缓存大小。
获取播放引擎的最大缓存大小。
判断播放器特性能力。
设置播放器 License 柔性校验。开启后,在播放器首次启动后前3次播放校验将默认通过。
设置腾讯云 PlayCGI 主机域名地址列表。

接口详情

setCacheFolderPath:

设置播放引擎的 Cache 目录,设置后,预下载,播放器等会优先从此目录读取和存储。
+ (void)setCacheFolderPath:(NSString *)cacheFolder;
参数说明
参数名
类型
描述
cacheFolder
NSString
缓存目录路径,nil 表示不开启缓存。

cacheFolderPath

获取设置的播放引擎的 Cache 目录。
+ (NSString *)cacheFolderPath;

setMaxCacheSize:

设置播放引擎的最大缓存大小,设置后会根据设定值自动清理 Cache 目录的文件。
+ (void)setMaxCacheSize:(NSInteger)maxCacheSizeMB;
参数说明
参数名
类型
描述
maxCacheSizeMB
NSInteger
最大缓存大小,单位:MB。

maxCacheSize

获取设置的播放引擎的最大缓存大小。单位 MB。
+ (NSInteger)maxCacheSize;

getOptions:

判断播放器特性能力。
+ (id)getOptions:(NSNumber *)featureId;

setLicenseFlexibleValid:

开启播放器 License 柔性校验。开启后,在播放器首次启动后前2次播放校验将默认通过。
+ (void)setLicenseFlexibleValid:(BOOL)value;

setPlayCGIHosts:

设置腾讯云 PlayCGI 主机域名地址列表,在内置域名请求失败时会启用设置的备用域名。
+ (void)setPlayCGIHosts:(NSArray<NSString *> *)hosts;
参数说明
参数名
类型
描述
hosts
NSArray<NSString *>
域名地址列表,域名格式为:playvideo.qcloud.com。
发起 PlayCGI 请求时依次使用传入的 hosts 地址,在某个 host 请求失败时自动切换到下个 host 重试请求。