播放器 SDK TCPlayer 快直播降级说明

一、降级场景

此外，在部分支持 WebRTC 的浏览器，也会出现解码失败或者服务端问题，这些情况下，播放器都会将 WebRTC 地址转换为兼容性较好的 HLS 地址来播放，这个行为称为降级处理。

总结一下，会触发降级的场景有以下几个：

·浏览器环境不支持 WebRTC 。

·连接服务器失败，并且连接重试次数已超过设定值 （内部状态码 -2004）。

·播放过程解码失败（内部状态码 -2005）。

·其他 WebRTC 相关错误（内部状态码 -2001）。

二、1. 自动降级

初始化播放器时，通过 sources 字段传入了快直播地址，在需要降级处理的环境，播放器自动会进行协议的转换，将快直播地址转换为 HLS 协议地址。

例如，快直播地址：

webrtc://global-lebtest-play.myqcloud.com/live/lebtest?txSecret=f22a813b284137ed10d3259a7b5c224b&txTime=69f1eb8c

会自动转换为：

https://global-lebtest-play.myqcloud.com/live/lebtest.m3u8?txSecret=f22a813b284137ed10d3259a7b5c224b&txTime=69f1eb8c

三、2. 指定降级

在播放自适应码率（ABR）场景，如果需要降级，并不能直接通过格式转换得到自适应码率的 HLS 地址，需要手动指定。又或者是在用户希望手动指定的其他场景，都可以通过如下方式指定降级地址，这里的地址并不局限于 HLS 协议，也可以是其他协议地址：

var player = TCPlayer('player-container-id',{ sources: 'webrtc://global-lebtest-play.myqcloud.com/live/lebtest?txSecret=f22a813b284137ed10d3259a7b5c224b&txTime=69f1eb8c&tabr_bitrates=d1080p,d540p,d360p&tabr_start_bitrate=d1080p', webrtcConfig: { fallbackUrl: 'https://global-lebtest-play.myqcloud.com/live/lebtest_HLSABR.m3u8', },});

四、降级回调

当触发降级时，播放器会触发回调：

player.on('webrtcfallback', function(event) { console.log(event);});