tencent cloud

TXVodPlayConfig
下载PDF
最后更新时间：2025-05-30 14:15:37
TXVodPlayConfig
最后更新时间： 2025-05-30 14:15:37
下载PDF

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
音轨名称。
本页内容是否解决了您的问题？
您也可以 联系销售 或 提交工单 以寻求帮助。
是
否

文档反馈