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
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
Parameter Template APIs
Task Flow APIs
Data Types
Error Codes
Video on Demand API 2024-07-18
常见问题
移动端播放问题
费用相关问题
视频上传问题
视频发布问题
视频播放问题
Web 端播放问题
全屏播放问题
数据统计问题
访问管理相关问题
媒资降冷问题
相关协议
Service Level Agreement
VOD 政策
隐私政策
数据处理和安全协议
联系我们
词汇表
文档云点播播放器 SDK 文档含 UI 集成方案Web 接入指引TCPlayer 快直播降级说明

TCPlayer 快直播降级说明

PDF
聚焦模式
字号
最后更新时间： 2024-05-13 17:49:25

降级场景

快直播基于 WebRTC 实现，依赖于操作系统和浏览器对于 WebRTC 的支持。
目前，SDK 对以下操作系统和浏览器进行了测试，测试结果如下：
操作系统
操作系统版本
浏览器类型
浏览器版本
是否支持拉流
Windows
win 10
Chrome
86+
✓
Firefox
88+
✓
Microsoft Edge
86+
✓
macOS
10.5+
Safari
13.1+
✓
Chrome
86+
✓
Firefox
88+
✓
Microsoft Edge
86+
✓
iOS
13.1.1+
Safari
13.7+
✓
Chrome
86+
✓
Firefox
33+
✓
Microsoft Edge
89
✓
微信内嵌
-
✓
Android
-
Chrome
86+
✓
Firefox
88+
✓
微信内嵌
X5 内核
✓
微信内嵌
XWeb 内核
✓
此外，在部分支持 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);
});
上一篇: TCPlayer 清晰度配置说明下一篇: iOS 接入指引

帮助和支持

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

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

文档反馈