含 UI 集成方案

诚邀爱技术、爱分享的你,成为文档内容共建者> HOT
版本号major.minor.patch具体规则如下:
major:主版本号,如有重大版本重构则该字段递增,通常各主版本间接口不兼容。
minor:次版本号,各次版本号间接口保持兼容,如有接口新增或优化则该字段递增。
patch:补丁号,如有功能改善或缺陷修复则该字段递增。
注意
建议您及时更新至最新版本,以便获得更好的产品稳定性及在线支持。
版本升级注意事项请参见:升级指引

Version 4.15.0 @2022.11.21

Feature

支持推辅流,可实现一个 Client 同时推摄像头 + 屏幕分享。请参见 屏幕分享教程
支持空间音频。请参见 实现空间音频
LocalStream.removeTrack 支持 remove audioTrack。

Bug Fixed

修复远端用户开启小流时,频繁 publish & unpublish 会偶现导致拉流异常的问题。

Version 4.14.7 @2022.11.04

Improvement

规避 MacOS Ventura 上 在 Safari 16 进行屏幕分享时黑屏的问题。

Version 4.14.6 @2022.10.28

Improvement
支持开启大小流的同时,调用 localStream 中操作 track 的相关接口(addTrack/removeTrack/replaceTrack/switchDevice)。
优化设备采集逻辑,当指定 deviceId 对应的设备不可用时,浏览器会自动选择一个可用的设备采集。
优化设备恢复采集逻辑。

Version 4.14.4 @2022.09.30

Improvement

规避 Mac Firefox 摄像头采集低于 352 * 288 分辨率报错的问题。Firefox issue
优化任务调度,降低资源消耗。

Bug Fixed

修复使用 localStream.replaceTrack 替换 videoTrack 后,拔插摄像头偶现 videoTrack 失效的问题。

Version 4.14.3 @2022.09.09

Bug Fixed

修复在严格模式下,Chrome 隐私模式偶现获取设备列表失败的问题。
修复页面未产生交互情况下进房,音量获取异常的问题。

Version 4.14.2 @2022.08.26

Feature

TRTC.getCamerasTRTC.getMicrophone 获取到的设备列表,支持调用原生接口 getCapabilities

Improvement

优化 iOS 端(接电话、闹铃、唤醒 Siri)等场景下,设备采集异常的恢复逻辑。
优化 H264 支持度检测逻辑,规避 Android Chrome 88 以下首次打开浏览器检测不支持 H264 的问题。

Version 4.14.1 @2022.08.11

Feature

支持发送 SEI 消息,Client.sendSEIMessage

Improvement

提升 Client.switchRole 接口健壮性。

Version 4.14.0 @2022.08.05

Breaking Change

修改 Client.on('client-banned') 事件的回调参数,升级时需注意。

Feature

支持设置采集音量,LocalStream.setAudioCaptureVolume

Improvement

修改 Client.on('client-banned') 事件回调参数,增加被动退房原因。
规避 Firefox 屏幕分享采集分辨率与预期不符的问题。
规避 iOS Safari 偶现播放本地流黑屏的问题。
优化低端 PC 设备的小流编码性能。

Bug Fixed

修复特定场景下,屏幕分享码率不及预期的问题。

Version 4.13.0 @2022.07.08

Feature

新增接口 Client.destroy,完善 Client 生命周期。

Improvement

优化小流编码性能,提升流畅度。
新增自动恢复采集成功事件 DEVICE_AUTO_RECOVERED

Bug Fixed

修复 Client.startMixTranscode 接口发起云端混流,断网超过 30s 且恢复网络后未继续混流的问题。
修复 Client.startPublishCDNStream 接口推流到 CDN,断网超过 30s 且恢复网络后 CDN 流断开的问题。

Version 4.12.7 @2022.06.17

Improvement

Client.startMixTranscode 支持通过 mixUser.renderMode 参数设置混入流渲染模式。
默认 video profile 变更为 480p_2,在保障画质的情况下,降低上行带宽消耗。参考 LocalStream.setVideoProfile
提升自动恢复播放成功率。
提升断网重连后,mute 状态准确性。
规避 Mac Safari 15.1 muteVideo 页面崩溃的问题。webkit bug

Bug Fixed

修复大小流场景下(非自动订阅),偶现未抛出 stream-added 事件的问题。

Version 4.12.6 @2022.06.10

Improvement

client.join 新增防重复进房逻辑,详情参考:升级指引

Version 4.12.5 @2022.05.20

Bug Fixed

修复在 IE 中加载 npm 包 trtc.umd.js 文件报错的问题。
修复偶现订阅状态变更,拉小流异常的问题。
规避 Chrome 70 及以下版本,移动 div 容器导致播放暂停的问题。

Version 4.12.4 @2022.05.07

Improvement

优化进房流程,降低进房耗时。
优化小流切换逻辑。

Bug Fixed

修复偶现未抛出 stream-added 事件的问题。
规避 Firefox 无法使用罗技摄像头采集 480p 的问题。
修复 iPad WKWebview 引入 sdk 报错的问题。

Version 4.12.3 @2022.04.19

Improvement

优化 iOS 13、14 高分辨率采集逻辑。
优化事件监听逻辑,避免 SDK 捕获到业务侧的错误。
新增 Safari 音量上报,便于仪表盘排障。

Bug Fixed

修复 live 模式偶现断网重连异常的问题。
修复 iOS 11 获取音量异常的问题。

Version 4.12.2 @2022.04.02

Improvement

优化音量计算逻辑,降低内存占用及性能开销。

Bug Fixed

修复偶现页面长时间切后台被踢问题(收到 client-banned 事件)。
规避 iOS 15.2 ~ 15.4 切换摄像头后,出现回音的问题。参考:iOS Safari 已知问题 case 11

Version 4.12.1 @2022.03.18

Noten升级至该版本需注意:升级指引

Improvement

stream.play 支持重复调用、设置镜像播放、动态修改播放参数。
完善自动恢复采集逻辑,规避偶现推流掉水印的问题。

Bug Fixed

修复 muteVideo/unmuteVideo 后,远端拉小流黑屏的问题。
修复切小流后,抛出 stream-subscribed 事件的问题。

Breaking Change

废弃 TRTC.createStream 接口的 mirror 属性,请使用 stream.play(elementId, { mirror: true })

Version 4.12.0 @2022.03.04

Noten升级至该版本需注意:升级指引

Feature

client.setRemoteVideoStreamType 改为异步,返回 Promise,可根据 Promise 状态判断切换大小流是否成功。

Improvement

优化海外服务调度准确性。

Bug Fixed

修复偶现收到 user_time_out 被踢的问题。

Version 4.11.13 @2022.02.17

Improvement

更新 npm 包 Typescript 声明文件。
优化 stream.play 参数校验逻辑。

Bug Fixed

修复 iOS 13 在未授权前偶现 LocalStream.initialize 失败报错的问题。
修复 AUDIO_VOLUME 事件偶现取值为0的问题。

Version 4.11.12 @2022.01.11

Improvement

npm 包提供 Typescript 声明文件。
优化 stream.close() 接口实现逻辑。
优化推流端频繁 publish/unpublish 的信令交互逻辑。

Bug Fixed

修复 iOS 15.1 开启桌面版网页通话时,出现页面 crash 的问题。详情参考:iOS Safari 已知问题 case 7
修复 LocalStream.setAudioProfile('high') 码率设置成 192kbps 的问题。

Version 4.11.11 @2021.12.17

Improvement

优化自动恢复采集逻辑,规避部分低端安卓机采集异常无法恢复的问题。
优化自动播放弹窗样式。

Version 4.11.10 @2021.12.03

Bug Fixed

修复设置 enableAutoPlayDialog: false 无法关闭 SDK 自动播放弹窗的问题。
修复重复调用 stream.play 未被 SDK 拦截的问题。

Version 4.11.9 @2021.11.26

Noten升级至该版本需注意:升级指引

Improvement

支持 SDK 在自动播放失败时,展示交互弹窗,以解决自动播放失败问题。详情参考:自动播放受限处理建议
优化【iOS 15.1 推流 crash 问题】的规避逻辑,详情参考:iOS Safari 已知问题 case 7
为规避可能出现的无声问题,TRTC.getMicrophones 不再返回 deviceId 为 'communications' 的麦克风。详情参考:Chrome 已知问题 case 8 & 9
优化 switchDevice 策略。
提升 webview 环境中的编解码支持度检测准确性。

Bug Fixed

修复偶现 client.publish 报错不支持 TRTC 的问题。

Version 4.11.8 @2021.11.05

Improvement

规避 iOS 15.0 偶现视频播放黑屏的问题,详情参考:iOS Safari 已知问题 case 6
规避 iOS 15.1 推流必现 crash 的问题,详情参考:iOS Safari 已知问题 case 7

Version 4.11.7 @2021.09.30

Improvement

关键接口增加参数类型强校验。
支持开发模式(LogLevel 为 Debug)下,中文错误信息提示。
提升设备采集异常时,自动恢复采集的成功率。
优化系统休眠,再启动后的通话恢复逻辑。
新增 trtc.esm.js 及 trtc.umd.js,满足不同场景需求,参考指引

Version 4.11.6 @2021.09.10

Improvement

优化信令调度逻辑,提升弱网下的进房成功率,建议 v4.11.5 升级至该版本。

Version 4.11.5 @2021.09.04

Improvement

支持信令通道动态调度,提升弱网环境下连接成功率。
支持跨房间混流,请参见:Client.startMixTranscode

Bug Fixed

修复偶现断网重连后,收不到 stream-added 事件的问题。
修复偶现长时间屏幕分享帧率掉0的问题。

Version 4.11.4 @2021.08.20

Improvement

提升在 oppo & vivo 内置浏览器中,H.264 支持度检测的准确性。
新增自动恢复采集逻辑(当设备采集异常时触发)。
新增 subscribe 接口的超时逻辑,参考错误码:API_CALL_TIMEOUT

Bug Fixed

修复部分老版本 iOS Safari 偶现拉流失败的问题。
修复切换设备后 mute 状态不准的问题。
修复进房超时后,重新调用进房接口,偶现异常的问题。
修复远端取消推流后,未及时销毁音视频播放器的问题。

Version 4.11.3 @2021.07.30

Improvement

优化 publish & subscribe 接口异常处理逻辑。
优化混音插件的恢复策略。

Bug Fixed

修复偶现 peer-leave 通知不准的问题。

Version 4.11.2 @2021.07.23

Improvement

支持 turn server 调度,提升连接成功率。
Client.getRemoteMutedState 新增属性 hasSmall,标识远端是否有推小流。

Bug Fixed

修复 LocalStorage 被禁用时,无法使用 SDK 的问题。
修复偶现 publish 异常时,接口未 rejected 的问题。

Version 4.11.1 @2021.06.25

Improvement

支持美颜插件,参考:开启美颜
优化数据统计准确性。

Version 4.11.0 @2021.06.18

Feature

支持大小流,参考教程:开启大小流传输

Improvement

优化事件通知时序。

Version 4.10.3 @2021.06.11

Improvement

优化质量数据统计逻辑,支持服务端 API 获取通话质量数据。
ClientEvent.NETWORK_QUALITY 事件返回 rtt 和 loss 数据。
优化接口校验逻辑,防止重复调用出现异常。
优化播放逻辑,降低音频播放耗时。

Version 4.10.2 @2021.05.24

Improvement

优化 switchDevice 接口实现逻辑,规避华为浏览器偶现无法切换前置摄像头的问题。
提升 StreamEvent.CONNECTION_STATE_CHANGED 事件通知准确性。

Bug Fixed

修复偶现无法播放 Native 屏幕分享的问题。
修复偶现重连后收不到 stream-removed 事件的问题。

Version 4.10.1 @2021.04.30

Feature

新增 StreamEvent.CONNECTION_STATE_CHANGED 事件,支持监听 Stream 的连接状态变更。
支持 Client.getTransportStats 接口获取下行 RTT 统计数据。
支持 Client.getRemoteVideoStats 接口获取辅流(屏幕分享)统计数据。

Improvement

优化 Client.switchRole 接口的实现逻辑。

Bug Fixed

修复偶现 mute 相关事件在 stream-added 之前触发的问题。
修复偶现进房无声问题。

Version 4.10.0 @2021.04.16

Feature

新增接口 Client.startPublishCDNStream,将流推送到腾讯云 CDN 及第三方 CDN。
新增接口 Client.stopPublishCDNStream,停止推流到腾讯云 CDN 及第三方 CDN。

Improvement

Version 4.9.0 @ 2021.03.19

Feature

云端混流支持预排版模式,请参见 Client.startMixTranscode 接口。
支持音量回调,请参见 Client.enableAudioVolumeEvaluation 接口。

Improvement

Websocket 的默认端口改为 443。

Bug Fixed

修复 live 模式下,观众收不到主播进退房通知的问题。
修复使用字符串房间号时,偶现重连失败的问题。

Breaking Change

TRTC.checkSystemRequirements 返回详细检测结果,具体请参见 接口文档升级指引

Version 4.8.6 @ 2021.03.01

Improvement

支持拉流立体声播放。
注意
iOS 平台暂不支持。

Bug Fixed

修复移动端静音静画时,Web 收到 stream-removed 事件的问题。

Version 4.8.5 @ 2021.01.29

Improvement

Client.setTurnServer 支持设置多个 turn server。
优化 userId 校验逻辑。

Bug Fixed

修复推流后,偶现 mute 状态不准确的问题。

Version 4.8.4 @ 2021.01.15

Improvement

LocalStream.setVideoProfile 接口支持动态调用。
优化仪表盘数据上报逻辑。
优化自动播放受限时的处理逻辑,请参见 自动播放受限处理建议
优化设备插拔自动恢复失败时的处理逻辑,请参见 DEVICE_AUTO_RECOVER_FAILED

Bug Fixed

修复重新推流后,偶现 mute 状态不准的问题。

Version 4.8.3 @ 2021.01.07

Improvement

优化进房接口 roomId 参数校验逻辑。

Bug Fixed

修复 v4.8.2 版本缺少第三方依赖的问题。
修复只订阅音频时,偶现播放无声的问题。
修复 iOS 自动播放受限后,偶现 resume 无声及 getAudioLevel 为0的问题。

Version 4.8.2 @ 2020.12.31

Improvement

优化进房接口 roomId 参数校验逻辑,详情请参见 接口文档升级指引
优化 peer-join 及 peer-leave 事件通知时机。

Bug Fixed

修复退房时,偶现报错 Cannot read property 'isConnected' of null 的问题。

Breaking Change

删除已废弃接口:setDefaultMuteRemoteStreams,请使用 TRTC.createClient 的 autoSubscribe 参数 替代。

Version 4.8.1 @ 2020.12.25

Bug Fixed

修复 Windows 偶现听不到远端用户声音的问题。
修复 client.getRemoteVideoStats() 接口返回空数据的问题。

Version 4.8.0 @ 2020.12.18

Feature

支持云端混流转码。
全平台支持字符串房间号,参考:TRTC.createClient 的 useStringRoomId 参数
支持关闭自动订阅,参考:TRTC.createClient 的 autoSubscribe 参数

Improvement

优化 h264 支持度检测逻辑。
优化设备切换逻辑。
优化 hasAudio/hasVideo 接口的状态判断逻辑。

Bug Fixed

修复断网重连偶现失败报错的问题。
修复 iOS Safari 频繁 add/remove track 黑屏问题。

Version 4.7.1 @ 2020.11.27

Improvement

优化媒体设备变更时(例如:接口松动、设备插拔等)的自动恢复采集逻辑。
新增错误码:DEVICE_AUTO_RECOVER_FAILED,可用于设备恢复失败时进行提示。

Bug Fixed

修复 Chrome/87 版本偶现报错黑屏的问题。
修复 Native 推摄像头 + 屏幕分享,Web 重复订阅、取消订阅,屏幕分享流消失的问题。

Version 4.7.0 @ 2020.11.20

Feature

支持桌面端 Firefox M56+ 及桌面端 Edge M80+。

Improvement

优化上行码率控制逻辑。
优化获取媒体设备重试逻辑。
优化 Websocket 重连逻辑。
优化设备变更时的自动恢复推流逻辑,支持混音状态下插拔麦克风自动恢复推流。

Breaking Change

TRTC.checkSystemRequirements 返回详细检测结果,具体请参见 接口文档升级指引

Version 4.6.7 @ 2020.11.05

Bug Fixed

修复 Chrome 开启硬件加速时,拉流观看偶现花屏的问题。
修复 iOS 微信内置浏览器无法进房拉流的问题。

Version 4.6.6 @ 2020.10.23

Improvement

优化上行 peerConnection 重连逻辑。
优化下行 peerConnection 重连逻辑。
优化 TRTC.checkSystemRequirements 检测逻辑。
支持 Safari 屏幕分享,具体请参见 屏幕分享使用教程

Bug Fixed

修复因自动播放策略限制,手动恢复音频播放后,getAudioLevel 值为0的问题。

Version 4.6.5 @ 2020.10.14

Improvement

优化 WebSocket 信令通道重连逻辑,提升连接稳定性。
优化日志输出逻辑。

Bug Fixed

修复 Chrome 重新订阅后,getAudioLevel 接口返回值为0的问题。
修复 Safari 重新订阅后,播放无声的问题。
修复使用 replaceTrack 替换上行音频轨道后,getLocalVideoStats 接口返回 undefined 的问题。
修复移动设备通话过程中,切换网络类型,偶现 WebSocket 连接断开的问题。

Version 4.6.4 @ 2020.09.24

Improvement

退房后停止网络质量统计。

Bug Fixed

修复 Chrome 56 进房报错的问题。
修复移动端推旁路出现画面旋转的问题。
修复纯音频推流时云端录制异常的问题。
修复因分辨率不一致导致摄像头拔出后,自动恢复推流失败的问题。

Version 4.6.3 @ 2020.08.28

Improvement

优化兼容性检测逻辑。
优化日志上报逻辑。
优化上行码率控制逻辑。

Version 4.6.2 @ 2020.08.14

Improvement

优化上行码率调控逻辑。
优化 switchRole 参数校验逻辑。
优化上行网络质量计算逻辑。
优化错误提示信息。
检测当前推流采集设备变更时,自动恢复推流状态。

Bug Fixes

修复 unpublish 成功后,立即重新 publish 失败报错的问题。

Version 4.6.1 @ 2020.07.28

Improvement

TRTC.isScreenShareSupported Safari 不支持屏幕分享。
完善 subscribe & unsubscribe 接口的参数校验逻辑。
增加网络质量日志。

Bug Fixes

修复当未授权媒体设备,且 TRTC.createStream 接口传入的设备 ID 为空串时,SDK 报 OverconstrainedError 的问题。
修复上行 peerConnection 断开时没有打印日志的问题。

Version 4.6.0 @ 2020.07.16

Feature

增加 NETWORK_QUALITY 事件。

Version 4.5.0 @ 2020.07.02

Feature

createStream 接口增加 screenAudio 参数。

Bug Fixes

修复 Android 浏览器中回声消除不起作用的问题。
修复 getTransportStats 接口返回的 rtt 值为 NAN 的问题。

Version 4.4.0 @ 2020.05.28

Feature

支持 Chrome >= 74 屏幕分享采集系统(Windows)或者当前 Tab 页面(Mac)的声音。

Version 4.3.14 @ 2020.04.29

Bug Fixes

修复小程序音频 muted unmute 事件。

Version 4.3.13 @ 2020.04.16

Improvement

优化可用性检测逻辑。

Version 4.3.12 @ 2020.04.13

Bug Fixes

修复一个潜在的 RTCPeerConnection 状态变化异常。

Version 4.3.11 @ 2020.03.28

Improvement

增加手机 QQ 浏览器检测,手机 QQ 浏览器暂时无法支持 TRTC 桌面浏览器 SDK。

Bug Fixes

修复 Boolean 返回值类型。

Version 4.3.10 @ 2020.03.17

Improvement

优化环境检测逻辑。
RtcError 增加 name code。

Version 4.3.9 @ 2020.03.13

Improvement

增加部署环境自动检测。
优化日志。

Version 4.3.8 @ 2020.02.24

Improvement

createClient 增加 streamId userdefinerecordid 字段。

Version 4.3.7 @ 2020.02.21

Improvement

屏幕分享时切换设备抛出异常。

Bug Fixes

切换设备时释放 MediaStream,解决设备占用问题。
订阅接口增加处理潜在错误。

Version 4.3.6 @ 2020.02.05

Bug Fixes

调整 Stream.resume() 音视频播放顺序,修复 iOS 上微信浏览器自动播放异常问题

Version 4.3.5 @ 2020.02.05

Improvement

增加 publish 超时检查,提高信令发送成功率

Version 4.3.4 @ 2020.01-06

Improvement

升级 core-js 至 v3.6.1。

Bug Fixes

unpublish 超时后向外部抛出异常事件。
修复第三方库引起 V8 负优化问题。

Version 4.3.3 @ 2019.12.25

Improvement

增加主动检测环境是否支持 webrtc 能力
优化 sdp 响应机制
优化上报逻辑

Bug Fixes

修复 turn URL 协议格式

Version 4.3.2 @ 2019.12.09

Improvement

增加下行连接 ICE 断开自动重连机制。
去除 STUN 打洞环节,增加内网用户连接成功率及提高连接速度。
日志上报时间戳统一使用服务器校正后的 UTC 时间。
优化 ICE 错误上报。
增加更多关键事件上报到 avmonitor 监控。

Bug Fixes

修复 WebSocket 信令通道1005异常重连及重连错误处理。
修复下行丢包率上报问题。

Version 4.3.1 @ 2019.11.23

Improvement

增加通话过程中上行链路 ICE 断开自动重连机制。

Bug Fixes

修复 STUN 打洞失败后 host 公网 IP 类型 ICE Candidate 不生效问题。

Version 4.3.0 @ 2019.11.15

Feature

增加 Client.getTransportStats() API。

Improvement

增加更详细的上报日志。
事件解除绑定支持通配符。
增加连接超时时间至5s。
增加发布超时时间至5s。

Bug Fixes

修复因 zone.js 修改原型链导致 SDK 判断异常的问题。

Version 4.2.0 @ 2019.11.04

Feature

增加 Client.off() 接口取消客户端事件绑定。

Improvement

通话状态统计优化。
Client.publish() 增加权限检查。
Stream.play()/resume() 增加自动播放错误提示。

Bug Fixes

LocalStream.switchDevice() 切换摄像头黑屏问题修复。

Version 4.1.1 @ 2019.10.24

Bug Fixes

修复日志丢失问题。
修复断网重连远端用户丢失问题。

Version 4.1.0 @ 2019.10.17

Feature

Stream.play() 接口支持传入 HTMLDivElement 对象。
增加音频码率调控设置,开发者可通过 LocalStream.setAudioProfile() 设置音频属性,目前支持两种 Profile:standard 和 high。

Bug Fixes

修复旧版本 Chrome 上的 WebAudio Context 数量受限问题。
修复 replaceTrack() 未重启本地音视频播放器问题。
修复 LocalStream.setScreenProfile() 自定义属性设置未生效问题。
修复 audio/video player 重启及状态上报问题。

Version 4.0.0 @ 2019.10.11

TRTC 桌面浏览器 SDK 重构版本,提供 Client/Stream 模式的接口,各对象职责更明确,语义更简洁明了。n重构版本与旧版本不兼容,除接口改动之外,还提供如下功能:
视频属性 (分辨率、帧率及码率)控制完全由 App 通过 SDK 的 LocalStream.setVideoProfile() 接口设置,不再支持老版本通过腾讯云控制台的“画面设定 (Spear Role)”。
SDK 在 Stream 对象中封装了音视频播放器,音视频播放完全由 SDK 控制。
提供远端流的订阅与取消订阅功能,开发者可以通过 Client.subscribe()/unsubscribe() 接口灵活控制远端流的音频、视频或音视频数据流的接收。
目录