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 政策
隐私政策
数据处理和安全协议
联系我们
词汇表

TXVodPlayConfig

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

TXVodPlayConfig API 简介

点播播放器播放配置, 需要在播放前设置。

接口概览

API
描述
设置播放器在异常场景下重连次数。
设置播放器连接超时时间。
设置播放器类型。
设置 Http header。
设置是否精确 seek。
设置播放 MP4 是否自动旋转角度。
设置是否平滑切换多码率 HLS。
设置缓存 MP4 文件扩展名。
设置进度回调间隔。
设置播放器最大播放缓冲大小。
设置预加载最大缓冲大小。
设置播放器是否允许加载渲染后处理服务。
设置 HLS 最优的码流进行起播。
设置 MP4 加密播放。
设置播放器播放的媒资类型。
设置播放器拓展参数。
设置启播时优先使用的音轨。

接口详情

setConnectRetryCount

设置播放器在异常场景下重连次数。
当 SDK 与服务器异常断开连接时,SDK 会尝试与服务器重连,通过此函数设置 SDK 重连次数,默认值为 3。
public void setConnectRetryCount(int count)
参数说明
参数名
类型
描述
count
int
播放异常场景下重连次数。

setTimeout

设置播放器连接超时时间,默认值为 10 秒。
public void setTimeout(int timeout)
参数说明
参数名
类型
描述
interval
int
连接超时时间,单位秒, 默认值为 10 秒。

setCacheFolderPath

设置点播缓存目录。
注意:此接口已经废弃,请使用 TXPlayerGlobalSetting#setCacheFolderPath 做全局配置。
public void setCacheFolderPath(String folderPath)
参数说明
参数名
类型
描述
folderPath
String
缓存路径。

setMaxCacheItems

设置缓存文件个数。
注意:此接口已经废弃,请使用 TXPlayerGlobalSetting#setMaxCacheSize 做全局配置。
public void setMaxCacheItems(int maxCacheItems)
参数说明
参数名
类型
描述
maxCacheItems
int
最大缓存条目。

setPlayerType

设置播放器类型,默认为腾讯云自研播放器。
public void setPlayerType(int playerType)
参数说明
参数名
类型
描述
playerType
int
播放器类型,取值有:
TXVodConstants#PLAYER_SYSTEM_MEDIA_PLAYER: Android 系统播放器。
TXVodConstants#PLAYER_THUMB_PLAYER:腾讯云自研播放器,默认值。

setHeaders

自定义配置播放器播放联网过程中携带的 Http header。
public void setHeaders(Map<String, String> headers)
参数说明
参数名
类型
描述
headers
Map<String, String>
自定义的 Http header 内容。

setEnableAccurateSeek

设置是否精确 seek,默认 true。
public void setEnableAccurateSeek(boolean accurateSeek)
参数说明
参数名
类型
描述
accurateSeek
boolean
是否精确 seek。

setAutoRotate

播放 MP4 文件时,若设为 YES 则根据文件中的旋转角度自动旋转。旋转角度可在 PLAY_EVT_CHANGE_ROTATION 事件中获得,默认值为 YES。
public void setAutoRotate(boolean autoRotate)
参数说明
参数名
类型
描述
autoRotate
boolean
播放时旋转角度是否自动旋转。

setSmoothSwitchBitrate

设置是否平滑切换多码率 HLS,默认 false。
public void setSmoothSwitchBitrate(boolean smoothSwitchBitrate)
参数说明
参数名
类型
描述
smoothSwitchBitrate
boolean
是否平滑切换多码率 HLS。

setCacheMp4ExtName

设置缓存 mp4 文件扩展名,默认为 mp4 。
public void setCacheMp4ExtName(String cacheMp4ExtName)
参数说明
参数名
类型
描述
cacheMp4ExtName
boolean
文件扩展名称。

setProgressInterval

设置进度回调间隔,默认为 0.5 秒回调一次。
public void setProgressInterval(int intervalMs)
参数说明
参数名
类型
描述
intervalMs
int
间隔时间,单位毫秒。

setMaxBufferSize

设置播放器最大播放缓冲大小,单位 MB 。
public void setMaxBufferSize(float maxBufferSize)
参数说明
参数名
类型
描述
maxBufferSize
float
播放缓冲大小。

setMaxPreloadSize

设置预加载最大缓冲大小,单位:MB。
public void setMaxPreloadSize(float maxPreloadSize)
参数说明
参数名
类型
描述
maxPreloadSize
float
预加载大小。

setFirstStartPlayBufferTime

设置播放器首缓需要加载的数据时长,单位 ms,默认值为100ms。
注意:此接口已经废弃,请使用 #setMaxBufferSize或 #setMaxPreloadSize 设置缓冲大小。
public void setFirstStartPlayBufferTime(int milliseconds)
参数说明
参数名
类型
描述
milliseconds
int
时长大小。

setEnableRenderProcess

设置播放器是否允许加载渲染后处理服务,默认关闭。
public void setEnableRenderProcess(boolean enableRenderProcess)
参数说明
参数名
类型
描述
enableRenderProcess
boolean
是否允许加载后渲染后处理服务。

setPreferredResolution

播放 HLS 有多条码流时,播放器根据设定的 preferredResolution 选最优的码流进行起播, preferredResolution 是宽高的乘积(width * height),
启播前设置才有效。
public void setPreferredResolution(long preferredResolution)
参数说明
参数名
类型
描述
preferredResolution
long
视频宽高的乘积(width * height)。

setEncryptedMp4Level

设置 MP4 加密播放,默认不加密。
public void setEncryptedMp4Level(int level)
参数说明
参数名
类型
描述
level
int
设置 MP4 播放和存储加密等级,从播放器高级版12.2 版本开始支持,目前支持:
TXVodConstants#MP4_ENCRYPTION_LEVEL_NONE:非加密播放,默认支持。
TXVodConstants#MP4_ENCRYPTION_LEVEL_L2:MP4 本地加密播放。

setMediaType

设置播放器播放的媒资类型,默认为 AUTO 类型。
public void setMediaType(int mediaType)
参数说明
参数名
类型
描述
mediaType
int
设置媒资类型,默认为 AUTO 类型。可选值有:
TXVodConstants#MEDIA_TYPE_AUTO,AUTO 类型(默认值,自适应码率播放暂不支持)。
TXVodConstants#MEDIA_TYPE_HLS_VOD,HLS 点播媒资。
TXVodConstants#MEDIA_TYPE_HLS_LIVE,HLS 直播媒资。
TXVodConstants#MEDIA_TYPE_FILE_VOD,MP4 等通用文件点播媒资(从 11.2 版本开始支持)。
TXVodConstants#MEDIA_TYPE_DASH_VOD,DASH 点播媒资(从 11.2 版本开始支持)

setExtInfo

设置播放器拓展参数。
public void setExtInfo(Map<String, Object> map)
参数说明
参数名
类型
描述
map
Map
拓展参数。

setPreferredAudioTrack

设置启播时优先使用的音轨,播放器高级版本 12.3 版本开始支持。
public void setPreferredAudioTrack(String audioTrackName)
参数说明
参数名
类型
描述
audioTrackName
String
音轨名称。

帮助和支持

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

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

文档反馈