TXVodPlayConfig API 简介
点播播放器播放配置,需要在播放前设置。
属性概览
属性名 | 类型 | 默认值 | 描述 |
connectRetryCount | number | 3 | 播放器在异常场景下重连次数。 |
connectRetryInterval | number | 3 | 播放器连接失败重试间隔,单位秒。 |
timeout | number | 10 | 播放器连接超时时间,单位秒。 |
headers | Map<string, string> | null | 自定义 HTTP header。 |
enableAccurateSeek | boolean | true | 是否精确 seek。 |
smoothSwitchBitrate | boolean | true | 平滑切换多码率 HLS。 |
progressInterval | number | 500 | 进度回调间隔,单位毫秒。 |
maxBufferSize | number | 0 | 最大播放缓冲大小,单位 MB。 |
maxPreloadSize | number | 0 | 预加载最大缓冲大小,单位 MB。 |
preferredResolution | number | -1 | 偏好分辨率,width × height。 |
mediaType | number | TXVodConstants.MEDIA_TYPE_AUTO | 媒资类型,默认 auto 类型,建议指定具体类型可以提升启播速度。 |
属性详情
connectRetryCount
播放器在异常场景下重连次数。
当 SDK 与服务器异常断开连接时,SDK 会尝试与服务器重连,通过此属性设置 SDK 重连次数,默认值为3。
connectRetryInterval
播放器连接失败重试间隔,单位秒,默认值为3秒。
timeout
播放器连接超时时间,单位秒,默认值为10秒。
headers
自定义配置播放器播放联网过程中携带的 HTTP header。
enableAccurateSeek
设置是否精确 seek,默认 true。
开启精确 seek 后,seek 会更加精确,但可能会稍慢一些。
smoothSwitchBitrate
设置是否平滑切换多码率 HLS,默认 true。
平滑切换会在切换码率时避免视频卡顿,但切换过程可能会较慢。
progressInterval
设置进度回调间隔,单位毫秒,默认值为500毫秒。
maxBufferSize
设置播放器最大播放缓冲大小,单位 MB。
maxPreloadSize
设置预加载最大缓冲大小,单位 MB。
preferredResolution
播放 HLS 有多条码流时,播放器根据设定的 preferredResolution 选最优的码流进行起播,preferredResolution 是宽高的乘积(width × height)。
启播前设置才有效。
mediaType
设置播放器播放的媒资类型,默认为 AUTO 类型。
可选值有:
TXVodConstants.MEDIA_TYPE_AUTO:AUTO 类型(默认值)。
TXVodConstants.MEDIA_TYPE_HLS_VOD:HLS 点播媒资。
TXVodConstants.MEDIA_TYPE_HLS_LIVE:HLS 直播媒资。
TXVodConstants.MEDIA_TYPE_FILE_VOD:MP4 等通用文件点播媒资。
TXVodConstants.MEDIA_TYPE_DASH_VOD:DASH 点播媒资。