有奖:文档满意度调查问卷,诚邀您填写> HOT
功能
腾讯云直播播放器的参数配置模块。
介绍
主要负责 V2TXLivePlayer 对应的参数设置,其中绝大多数设置项在播放开始之后再设置是无效的

常用设置项

setAutoAdjustCacheTime

设置是否自动调整缓存时间。
void setAutoAdjustCacheTime(boolean bAuto)
参数
参数
类型
含义
bAuto
boolean
true:启用; false:关闭。
介绍
接口说明:
默认值:true。
true:启用自动调整, SDK 将根据网络状况在一个范围内调整缓存时间;通过 setMaxAutoAdjustCacheTimesetMinAutoAdjustCacheTime 两个接口来进行设置。
false:关闭自动调整, SDK 将使用固定缓存时长;通过 setCacheTime(float) 来进行设置。

setCacheTime

设置播放器缓存时间。
void setCacheTime(float time)
参数
参数
类型
含义
time
float
播放器缓存时长。
介绍
接口说明:
设置播放器缓存时间,单位为秒,默认值为5秒。
不建议设置过大,会影响秒开以及直播流播放的实时性。

setMaxAutoAdjustCacheTime

设置最大的缓存时间。
void setMaxAutoAdjustCacheTime(float time)
参数
参数
类型
含义
time
float
播放器最大缓存时间。
介绍
接口说明:
默认值:5,单位为秒。
仅在启用自动调用缓存时间接口时,有效。

setMinAutoAdjustCacheTime

设置最小的缓存时间。
void setMinAutoAdjustCacheTime(float time)
参数
参数
类型
含义
time
float
播放器最小缓存时间。
介绍
接口说明:
默认值:1,单位为秒。
仅在启用自动调用缓存时间接口时,有效。

setVideoBlockThreshold

设置播放器视频卡顿报警阈值。
void setVideoBlockThreshold(int threshold)
参数
参数
类型
含义
threshold
int
播放器视频卡顿报警阈值。
介绍
接口说明:
默认值:800,单位为毫秒。
当渲染间隔超过此阈值时候,表明产生了卡顿;播放器会通过 ITXLivePlayListener#onPlayEvent(int, Bundle) 回调 PLAY_WARNING_VIDEO_PLAY_LAG 事件通知。

setConnectRetryCount

设置播放器重连次数。
void setConnectRetryCount(int count)
参数
参数
类型
含义
count
int
SDK 重连次数。
介绍
接口说明:
默认值:3;取值范围:1 - 10。
当 SDK 与服务器异常断开连接时,SDK 会尝试与服务器重连;您可通过此接口设置重连次数。

setConnectRetryInterval

设置播放器重连间隔。
void setConnectRetryInterval(int interval)
参数
参数
类型
含义
interval
int
SDK 重连间隔。
介绍
接口说明:
默认值:3,单位为秒;取值范围:3 - 30。
当 SDK 与服务器异常断开连接时, SDK 会尝试与服务器重连;您可通过此接口设置连续两次重连的时间间隔。

专业设置项

setEnableMessage

开启消息通道。
void setEnableMessage(boolean enable)
参数
参数
类型
含义
enable
boolean
true:开启,false:关闭。
介绍
此接口在视频帧与消息需要高同步的情况使用,如:直播答题场景。 接口说明:
默认值:false。
此接口需要搭配 TXLivePusher#sendMessageEx(byte[]) 使用。
此接口存在一定的性能开销以及兼容性风险。

enableAEC

设置回声消除。
void enableAEC(boolean enable)
参数
参数
类型
含义
enable
boolean
true:开启; false:关闭。
介绍
接口说明:
默认值为:false。
连麦时,麦克风和播放有回音,所以必须开启回声消除。非连麦情况下,建议不开启。

待废弃设置项

setEnableNearestIP

设置就近选路。
void setEnableNearestIP(boolean enable)
参数
参数
类型
含义
enable
boolean
true:开启;false:关闭。
介绍
待废弃,默认值:true。 只对加速拉流生效,用于指定加速拉流是否开启就近选路。

setRtmpChannelType

设置 RTMP 传输通道的类型。
void setRtmpChannelType(int type)
参数
参数
类型
含义
type
int
通道类型。
介绍
待废弃,默认值:TXLiveConstants#RTMP_CHANNEL_TYPE_AUTO。 通道类型说明:
TXLiveConstants#RTMP_CHANNEL_TYPE_AUTO :自动。
TXLiveConstants#RTMP_CHANNEL_TYPE_STANDARD:标准的 RTMP 协议,网络层采用 TCP 协议。
TXLiveConstants#RTMP_CHANNEL_TYPE_PRIVATE:标准的 RTMP 协议,网络层采用私有通道传输(在 UDP 上封装的一套可靠快速的传输通道),能够更好地抵抗网络抖动;对于播放来说,私有传输通道只有在拉取低时延加速流时才可以生效。

setHeaders

设置自定义 HTTP Headers。
void setHeaders(Map< String, String > headers)
参数
参数
类型
含义
headers
Map< String, String >
HTTP 头。