更新日志
更新时间： 2024/07/29 09:42:28
本文介绍了网易云信音视频通话 SDK（简称 NERTC SDK）适配 Web 应用（包括 HTML5）的功能更新记录。
近期重要更新
-
V5.6.30：支持音量增益、增加视频恢复播放策略。
-
V5.6.21：当触发屏幕共享区域限制时，屏幕共享音频同时关闭。
-
V5.6.20：屏幕共享支持区域限制。
-
V5.6.10：新增远端流美声变声功能，具体请参考 AI 音效-远端流美声变声。
单击展开查看 V4.6.20 ~ V5.6.0 版本的近期重要更新。
-
- 新增实时字幕功能，具体请参考 打开实时字幕。
- 新增
video-resize事件，当视频分辨率发生变化时触发该事件，具体请参考 on('video-resize')。 - 从 v5.6.0 版本开始，插件版本需同主 SDK 版本一致才可使用。
-
- 新增音频数据回调功能，具体请参考 开启音频回调。
- Chrome 122 版本，getStats API 存在变更，会导致 Client 类中 Stats 相关 API 无效，如业务中存在相关依赖请尽快将 NERTC SDK 升级到 V5.5.30 版本。
-
V5.5.10：支持 限定 RTC SDK 的 访问区域，满足客户在海外访问域名的合规性。
-
V5.5.0 修复了 Chrome 117 版本（预计 2023 年 9 月 6 日上线）
getStatsAPI 变化引起的控制台异常报错。- 如果您升级到 Chrome 117 版本后，音视频功能正常，但控制台提示每秒 1 条的报错，请尽快将 NERTC SDK 升级到 V5.5.0 版本。
- 在升级期间，您可以申请 Chrome Origin Trial，以避免在线上出现该报错。
-
V4.6.25：支持 高级 Token 鉴权 ，支持对用户创建、加入房间和订阅、发布音视频流的权限进行校验，帮助您有效避免客户端遭遇破解攻击的问题。
-
V4.6.20：支持以 插件化 方式集成 美颜、虚拟背景，提升 SDK 集成的灵活性与易操作性，您可以根据需要自行选择是否集成对应特性的动态库，使 App 的包体积更小，具体请参考 集成 SDK。
5.6.30 (2024-07-26)
新增特性
- 支持采集音量增益，麦克风采集音量可以突破 100。Mozilla Firefox 浏览器暂不支持该特性。
- HTML5 竖屏应用在切换到后台时，可能会导致视频暂停，新增视频恢复播放策略。
- 其它若干项 SDK 优化。
5.6.21 (2024-07-11)
新增特性
当触发屏幕共享区域限制时，屏幕共享音频同时关闭。
5.6.20 (2024-07-10)
新增特性
屏幕共享支持区域限制。
5.6.10 (2024-06-13)
新增特性
新增远端流美声变声功能，具体请参考 AI 音效 远端流美声变声章节。
5.6.0 (2024-04-25)
新增特性
新增 video-resize 事件，当视频分辨率发生变化时触发该事件。
5.5.30 (2024-02-21)
新增特性
- 支持音频数据回调。使用 Safari 浏览器时，需要在 15 版本及以上。
- 自定义辅音可单独开启。
新增 API
API |
API 说明 |
|---|---|
enableAudioFrame |
开启音频 PCM 数据回调 |
disableAudioFrame |
关闭音频 PCM 数据回调 |
问题修复
- 修复了 Chrome 122 版本开始，Client 类中 Stats 相关 API 无效的问题
5.5.12 (2023-12-22)
问题修复
- 修复移动端 chrome58 拉流黑屏的问题
5.5.11 (2023-11-30)
新增特性
- 原 AI 降噪升级为 AI 音效，新增支持美声变声混响。AI 降噪使用方式存在变更，具体请参考 AI 音效。
- 支持啸叫检测。
新增 API
API |
API 说明 |
|---|---|
enableAudioEffect |
开启美声变声。 |
disableAudioEffect |
关闭美声变声。 |
setAudioEffect |
设置美声变声效果。 |
enableAIhowling |
开启啸叫检测。 |
disableAIhowling |
关闭啸叫检测。 |
onAudioHasHowling |
注册啸叫回调。 |
5.5.10 (2023-11-15)
新增特性
支持限定访问区域。为满足客户在海外访问域名合规性，网易云信支持 限定 RTC SDK 的访问区域 功能。无论用户身处何地使用 App，SDK 都只会访问指定区域的域名。
新增 API
API |
API 说明 |
|---|---|
NERTC.setArea |
指定 RTC Web SDK 访问区域。 |
5.5.2 (2023-10-19)
网易云信于 2023 年 10 月 19 日发布了 NERTC SDK 最新版本 V5.5.2。
问题修复
修复了在谷歌 Chrome 117 以上版本中，调用 getSessionStats 和 getTransportStats 接口返回数据异常的问题。
5.5.0 (2023-09-04)
网易云信于 2023 年 9 月 4 日发布了 NERTC SDK 最新版本 V5.5.0。
新增特性
音频辅流支持 3A 算法（回声消除 AEC、降噪 ANS、增益补偿 AGC）
改进优化
兼容 Vue3 代理。
问题修复
-
修复了 Chrome 117 版本（预计 2023 年 9 月 6 日上线）
getStatsAPI 变化引起的控制台异常报错。如果您升级到 Chrome 117 版本后，音视频功能正常，但控制台提示每秒 1 条的报错，请尽快将 NERTC SDK 升级到 V5.5.0 版本。
在升级期间，您可以申请 Chrome Origin Trial，以避免在线上出现该报错。申请地址：https://developer.chrome.com/origintrials/#/register_trial/3633278999381147649。
-
修复了发送端使用 360 极速浏览器 X 可能出现黑屏的问题。
-
修复了发送端未正确关闭屏幕共享音频，导致断网重连后可能出现视频丢失的问题。
-
修复发送端调用
switchDevice切换设备后，getAudioLevel函数的返回值持续为 0 的问题。 -
修复了断网期间日志上报可能丢失的问题。
-
修复了在部分 iOS webview 环境下，反复开关音视频会导致异常行为的问题。
-
修复了服务端调用踢人 API 后，用户重新登录时，报错内容不正确的问题。
-
修改掉线时报错的提示信息，将 MEDIA_TRANSPORT_DISCONNECT 改为 SOCKET_ERROR。
-
修复了火狐浏览器与其他 SDK 共同使用时发生冲突的问题。
新增 API
API |
API 说明 |
|---|---|
Stream.setAudioProcessing |
可以在创建本地流后、采集之前，开启或关闭音频 3A。该接口支持主辅流的音频。 |
变更 API
API |
API 说明 |
|---|---|
Stream.getAudioLevel |
音量的取值范围从 0 ~ 1 修改为 0 ~ 100。一般会议场景下，音量高于 40 可以认为有人在发言。 |
5.4.0 (2023-06-15)
网易云信于 2023 年 6 月 15 日发布了 NERTC SDK 最新版本 V5.4.0。
改进优化
优化了上下行传输质量。
问题修复
- 修复了在桌面端高版本 Safari(16.3+) 浏览器中进行屏幕共享时，采集失败的问题。
- 修复了 Safari 15.1 版本浏览器中，摄像头采集分辨率异常的问题。
变更 API
API |
API 说明 |
|---|---|
Stream.open |
增加 enableMediaPub 参数，用户可以根据需要选择是否发布流。 |
4.6.50 (2023-03-15)
网易云信于 2023 年 3 月 15 日发布了 NERTC SDK 最新版本 V4.6.50。
新增特性
序号 |
新增特性 |
特性描述 |
相关文档 |
|---|---|---|---|
| 1 | 调节整个房间的播放音量 | 支持通过 Client.setPlaybackVolume 调节整个房间所有远端用户在本地的播放音量。 |
设置通话音量 |
| 1 | 获取音频上行 rtt 延迟数据 | 支持通过 getLocalAudioStats 获取音频上行 rtt 延迟数据，以便用户判断当前网络状况好坏。 |
通话中质量监测 |
问题修复
- 修复在 iOS 16 上执行
switchDevice切换摄像头后，本地画面停留在第一帧的问题。 - 修复 mute 后再发布音视频，对端收不到 mute 消息的问题。
- 修复 Chrome 85 及以下版本浏览器中，远端音量不显示 active-speaker 的问题。
新增 API
API |
API 说明 |
|---|---|
Client.setPlaybackVolume |
调节房间内所有远端用户在本地的播放音量。 |
变更 API
API |
API 说明 |
|---|---|
subscribe |
支持将 setSubscribeConfig 和 subscribe 合二为一，在 subscribe 中直接指定订阅的媒体类型。 |
setLocalRenderMode |
视频的宽和高新增支持小数。 |
getLocalAudioStats |
新增 rtt 参数，获取音频上行 rtt 延迟数据，以便用户判断当前网络状况好坏。 |
4.6.40 (2023-01-13)
网易云信于 2023 年 1 月 13 日发布了 NERTC SDK 最新版本 V4.6.40。
改进优化
- 优化错误码（errorCode），可以帮助您快速排查问题原因，具体请参考 错误码。
- 优化视频码率参考表，新增 30 帧的帧率选项。
- 优化 Firefox 浏览器环境下的断线重连问题。
- 优化 Electron 平台的音视频体验。
问题修复
- 修复使用虚拟背景或高级美颜插件时偶现的视频空白问题。
- 修复使用 AI 降噪功能场景下的已知问题。
- 修复直播推流、云代理、网络状态回调失败的问题。
- 修复 Electron 平台的屏幕共享问题。
- 修复切换伴音与麦克风模式时，麦克风反复开关的问题。
新增 API
API |
API 说明 |
|---|---|
getCurrentFrameData |
获取当前帧的数据。 |
canPlay |
判断音视频流是否可以播放。 |
checkBrowserCompatibility |
获取当前浏览器支持 WebRTC 的基本能力。 |
4.6.25 (2022-11-08)
网易云信于 2022 年 11 月 8 日发布了 NERTC SDK 最新版本 V4.6.25。
若您使用的是 iOS 16 系统，由于系统限制原因，可能无法正常动态切换视频分辨率。此外，若您使用了自定义视频采集，来源为 Canvas 的视频在本地可能无法正常播放。
新增特性
序号 |
新增特性 |
特性描述 |
相关文档 |
|---|---|---|---|
| 1 | AI 降噪 | 提供虚拟背景插件 AIDenoise，可以与 NERTC Web SDK 搭配使用。支持通过开启 AI 降噪功能，在嘈杂环境中针对背景人声、键盘声等非稳态噪声进行定向降噪，同时也会提升对于环境稳态噪声的抑制，保留更纯粹的人声。 |
AI 降噪 |
| 2 | 高级 Token 鉴权 | 支持通过权限密钥校验用户的加入或创建房间、发布或订阅音视频流的权限。 | 高级 Token 鉴权 |
| 3 | 高级美颜 | 新增去除抬头纹、法令纹、黑眼圈及调整嘴巴宽度和脸长等功能。 | 高级美颜 |
改进优化
- 新增部分错误码（errorCode），具体请参考 错误码。
- 提升对远端下行流的订阅速度。
- 视频帧率新增 30 帧的可选项。
问题修复
- 修复部分设备上出现的视频小流黑屏问题。
- 修复 iOS 16 系统中调用
stream.play()接口无法播放部分远端视频流以及无返回值的问题。 - 修复开启美颜功能后日志停止上传的问题。
- 修复了部分低版本浏览器无法获取本地音量的问题。
- 修复了部分重连场景下，重连过程中抛出
SOCKET_ERROR事件的问题。
新增 API
API |
API 说明 |
|---|---|
enableAIDenoise |
开启 AI 降噪。 |
disableAIDenoise |
关闭 AI 降噪。 |
updatePermKey |
更新高级权限 Token。 |
变更 API
API |
API 说明 |
|---|---|
getAudioLevel |
支持获取远端麦克风的采集音量，可以通过 mediaType 指定获取主流或辅流音量。 |
join |
JoinOptions 结构体新增 permKey 参数，用于高级 Token 鉴权。 |
4.6.21 (2022-09-02)
改进优化
- 支持恢复由于系统回收 GPU 资源导致丢失的 WebGL 上下文。
- 修复浏览器显卡黑名单机制导致的 WebGL 兼容问题。
- 修复 Android 端用户无法接收到 Web 端用户离开房间回调的问题。
4.6.20 (2022-08-15)
网易云信于 2022 年 8 月 15 日发布了 NERTC SDK 最新版本 V4.6.20。
新增特性
序号 |
新增特性 |
特性描述 |
相关文档 |
|---|---|---|---|
| 1 | 虚拟背景 | 提供虚拟背景插件 VirtualBackground，可以与 NERTC Web SDK 搭配使用。支持通过开启虚拟背景功能，将用户人像和背景分割开来，虚化用户周围的真实环境，或者以自定义背景色或背景图像替换真实背景。 |
虚拟背景 |
| 2 | 高级美颜 | 提供美颜插件 AdvancedBeauty，可以与核心 SDK 搭配使用。支持通过调整美颜相关参数，对人脸进行美型等美颜调整，帮助您轻松实现高级美颜功能。 |
高级美颜 |
| 3 | 屏幕共享偏好设置 | 支持在屏幕共享过程中设置共享偏好，根据共享内容为静态或动态画面调整编码倾向。 | 屏幕共享 |
| 4 | 音频辅流 | 支持在视频通话或互动直播的过程中以音频辅流的形式实现音频共享。 | 音频共享 |
改进优化
序号 |
改进优化 |
特性描述 |
相关文档/ API |
|---|---|---|---|
| 1 | 支持音频双声道兼容模式 | 兼容一些特殊音频设备由于不适配双声道导致的无声问题。 | enableCompatMode 等 |
| 2 | 支持 ASL 音频选路策略 | 通过 ASL 策略，在大房间的场景中降低客户端上性能消耗，来提升客户端上能支持的用户连接上限。 | - |
| 3 | 增加 iOS 14.3 及以上版本微信浏览器的适配 | - |
新增 API
API |
API 说明 |
|---|---|
muteAudioSlave |
静音音频辅流。 |
unmuteAudioSlave |
取消静音音频辅流。 |
hasAudioSlave |
判断是否有音频辅流。 |
setAudioSlaveVolume |
设置音频辅流的音量。 |
enableCompatMode |
开启音频双声道兼容模式。 |
disableCompatMode |
关闭音频双声道兼容模式。 |
registerPlugin |
注册高级美颜/背景分割插件。 |
unregisterPlugin |
注销高级美颜/背景分割插件。 |
enableAdvancedBeauty |
开启高级美颜。 |
disableAdvancedBeauty |
关闭高级美颜。 |
setAdvBeautyEffect |
设置美颜效果。 |
presetAdvBeautyEffect |
预设美颜参数。 |
enableBodySegment |
开启背景分割。 |
disableBodySegment |
关闭背景分割。 |
setBackGround |
设置背景。 |
Client.on('mute-audio-slave') |
静音音频辅流的回调。 |
Client.on('unmute-audio-slave') |
取消静音音频辅流的回调。 |
localStream.on('plugin-load') |
高级美颜/背景分割插件加载成功的回调。 |
localStream.on('plugin-load-error') |
高级美颜/背景分割插件加载失败的回调。 |
localStream.on('basic-beauty-res-complete') |
通知基础美颜资源加载完成的回调。 |
变更 API
API |
API 说明 |
|---|---|
setVideoEncoderConfiguration |
增加 contentHint 参数，以设置屏幕共享偏好。 |
setVideoProfile |
支持在通话中动态设置视频属性。 |
setSubscribeConfig |
mediaType 参数新增 audioSlave 字段，以配置音频辅流。 |
play |
mediaType 参数新增 audioSlave 字段，以配置音频辅流。 |
stop |
mediaType 参数新增 audioSlave 字段，以配置音频辅流。 |
Client.on('stream-added') |
mediaType 参数新增 audioSlave 字段。 |
Client.on('stream-subscribed') |
mediaType 参数新增 audioSlave 字段。 |
Client.on('stream-removed') |
mediaType 参数新增 audioSlave 字段。 |
Client.on('volume-indicator') |
type 参数新增 audioSlave 字段。 |
setVideoEncoderConfiguration |
新增 contentHint 参数，以设置屏幕共享偏好。 |
4.6.10 (2022-06-01)
网易云信于 2022 年 6 月 1 日发布了 NERTC SDK 最新版本 V4.6.10。
新增特性
序号 |
新增特性 |
特性描述 |
相关文档 |
|---|---|---|---|
| 1 | 基础美颜 | 网易云信自研的基础美颜功能，支持在音视频通话或互动直播场景中，对人脸进行美肤、美型等美颜调整，或通过画面滤镜改变视频的色调与氛围。 | 网易云信美颜 |
| 2 | 视频编码水印 | 支持为视频流画面添加编码水印，例如添加公司名称、标语等文字水印、录制时间等时间戳水印、以及 logo 等图片水印。 | 水印 |
| 3 | 视频截图 | 支持视频截图转 Base64。 | 视频截图 |
新增 API
API |
API 说明 |
|---|---|
setBeautyEffect |
开启或关闭美颜。 |
setBeautyEffectOptions |
设置美颜参数。 |
setFilter |
设置滤镜参数。 |
setEncoderWatermarkConfigs |
设置视频水印。 |
takeSnapshotBase64 |
截取指定用户的视频流画面，并生成 Base64 字符串。 |
4.6.0 (2022-03-02)
网易云信于 2022 年 3 月 2 日发布了 NERTC SDK 最新版本 V4.6.0。
新增特性
序号 |
新增特性 |
特性描述 |
相关文档 |
|---|---|---|---|
| 1 | 支持自定义辅流通道 | 提供辅流传输通道，帮助您传输非摄像头采集的外部视频源等自定义视频源。 | 自定义视频采集 |
| 2 | 云代理 | 支持使用云代理服务穿透防火墙限制，使用固定 IP 连接到网易云信服务器。 | 云代理 |
改进优化
序号 |
改进优化 |
特性描述 |
相关文档/ API |
|---|---|---|---|
| 1 | 设备插拔的监听回调 | 监听桌面端设备的麦克风、扬声器、摄像头等外接硬件的插拔动作，当发生相应动作时 SDK 会通过回调接口通知客户。 | Client.on("recording-device-changed") 等 |
| 2 | 支持发布大小流 | 优化视频清晰度订阅机制。本地用户可以选择同时发布两种规格的视频流，例如 720P 和 1080P，远端用户可以根据自身的网络情况选择订阅视频的清晰度。 | enableDualStream 等 |
| 3 | Web 桌面端兼容性提升 | 支持 FireFox、Edge 等最新版本的浏览器。 | Web 端支持的浏览器类型和版本 |
新增 API
API |
API 说明 |
|---|---|
| getAudioEffectsDuration | 获取音效文件时长。 |
| getAudioEffectsCurrentPosition | 获取音效文件当前播放进度。 |
| enableDualStream | 设置发送大小流。 |
| disableDualSteam | 取消发送大小流。 |
| setRemoteVideoStreamType | 设置接收大流或小流。 |
| startProxyServer | 开启云代理服务。 |
| stopProxyServer | 关闭云代理服务。 |
| Client.on("recording-device-changed") | 通知应用有音频输入设备被添加、更改或移除的回调。 |
| Client.on("camera-changed") | 通知应用有视频输入设备被添加、更改或移除的回调。 |
| Client.on("playout-device-changed") | 通知应用有音频输出设备被添加、更改或移除的回调。 |
变更 API
API |
API 说明 |
|---|---|
| createStream | StreamOptions 新增参数 screenAudioSource、screenVideoSource，设置自定义辅流音视频源。 |
| open | options 新增参数 screenVideoSource，设置自定义辅流视频源。 |
4.5.1 (2021-11-18)
问题修复
- 修复了 iOS 15.1 上 Safari 视频上行发送 H264 会导致页面崩溃的问题。
4.5.0 (2021-10-22)
网易云信于 2021 年 10 月 22 日发布了 NERTC SDK 最新版本 V4.5.0。
新增特性
序号 |
新增特性 |
特性描述 |
相关文档 |
|---|---|---|---|
| 1 | Web 端支持音频共享 | 自 V4.5.0 版本开始，在音频共享时，可以同时共享本地播放的音频流和麦克风采集的音频流。 | 屏幕共享 |
| 4 | 云端录制支持通过服务端 API 接口配置 | 云端录制支持通过服务端接口进行录制任务的配置。 | - |
改进优化
序号 |
改进优化 |
特性描述 |
相关文档 |
|---|---|---|---|
| 1 | 改进了自动播放受限问题 | 自动播放受限表现优化 | 浏览器自动播放受限处理 |
| 2 | 包大小优化 | Web SDK 包大小缩减至 0.8MB。 | - |
| 3 | uid 长度 | Web 端 uid 长度对齐移动端。 | - |
API 变更
API |
API 说明 |
|---|---|
| Stream.close | type 参数新增 screenAudio 枚举值。 |
| setCaptureVolume | 新增 mediaTypeAudio 参数。 |
| takesnapshot | 调用时机由 Client.publish 之前调整为 Client.publish 前后均可。 |
| Client.join | 从 V4.5.0 版本开始，uid 支持 String 类型。为保证跨平台互通，Sting 类型的 uid 需要设置为十进制数字。 |
4.4.1 (2021-08-03)
问题修复
- 修复了 频道中有 Linux 端时 active-speaker 回调概率性缺失的问题
- 修复了日志上传依赖 jQuery 的问题。
4.4.0 (2021-07-13)
网易云信于 2021 年 7 月 13 日发布了 NERTC SDK 最新版本 V4.4.0。
新增特性
| 序号 | 新增特性 | 特性描述 | 相关文档 |
|---|---|---|---|
| 1 | 加入房间时自动生成 uid | 加入音视频房间时，可以不设置 uid，此时网易云信服务器会自动为您生成一个随机 uid，并支持通过 getUid 获取本地用户 ID。 | join |
| 2 | 支持媒体流加密 | 网易云信在默认加密算法的基础上，提供了国密加密方案，进一步保障数据安全。 | 媒体流加密 |
| 3 | 支持日志上传 | Web 端加入房间之前开启日志上传，通话结束后相关日志会上传到网易云信服务器，以供问题排查。 | enableLogUpload |
| 4 | 支持 npm 方式获取 Web SDK | Web SDK 增加 npm 获取方式。 | 集成 SDK |
改进优化
改善了网络连通性。
API 变更
自 V4.4.0 开始，入口 WebRTC2 更名为 NERTC，同时兼容 WebRTC2。
新增 API
| API | API 说明 |
|---|---|
| setEncryptionMode | 设置媒体流加密模式。 |
| setEncryptionSecret | 设置媒体流加密秘钥。 |
| enableLogUpload | 开启日志上传。 |
| disableLogUpload | 关闭日志上传。 |
| getUid | 获取本地用户 ID。 |
变更 API
| API | API 说明 |
|---|---|
| join | 从 V4.4.0 版本开始，uid 可选且默认为 0。 |
| Client.on | 增加事件 "crypt-error"。 |
废弃 API
无
4.3.0 (2021-06-04)
网易云信于 2021 年 6 月 4 日发布了 NERTC SDK 最新版本 V4.3.0。
新增特性
| 序号 | 新增特性 | 特性描述 | 相关文档 |
|---|---|---|---|
| 1 | 支持屏幕共享时同时共享本地音频 | Web 端在 Windows 和 macOS 平台的 Chrome 浏览器中支持屏幕共享的同时共享本地播放的音频数据。 | screenAudio |
| 2 | 支持设备兼容性检测和编解码格式检测 | 调用接口即可判断 SDK 对当前浏览器的适配情况、检查 SDK 和当前浏览器同时支持的编解码格式。 | getsupportedcodec、checksystemrequirements |
| 3 | Web 端支持音效功能 | Web 端支持音效功能，可以在通话中增加鼓掌、欢呼等自定义音效设置，增加场景气氛。 | - |
改进优化
优化高清音质下语音的传输码率，在弱网情况下预计减少 1/3。
问题修复
修复 Web SDK 偶现的机关枪声音问题。
新增 API
| API | API 说明 |
|---|---|
| getsupportedcodec | 检查 NERTC Web SDK 和当前浏览器同时支持的编解码格式。 |
| checksystemrequirements | 检查 NERTC Web SDK 对正在使用的浏览器的适配情况。 |
| Stream.playEffect | 播放指定音效文件。 |
| Stream.stopEffect | 停止播放指定音效文件。 |
| Stream.pauseEffect | 暂停播放指定音效文件。 |
| Stream.resumeEffect | 恢复播放指定音效文件。 |
| Stream.setVolumeOfEffect | 调节指定音效文件的音量。 |
| Stream.preloadEffect | 预加载指定音效文件。 |
| Stream.getEffectsVolume | 释放指定音效文件。 |
| Stream.setEffectsVolume | 获取所有音效文件播放音量。 |
| Stream.stopAllEffects | 设置所有音效文件播放音量。 |
| Stream.pauseAllEffects | 停止播放所有音效文件。 |
| Stream.resumeAllEffects | 暂停播放所有音效文件。 |
变更 API
| API | API 说明 |
|---|---|
| screenAudio | StreamOptions 新增 screenAudio 参数。 |
| screenAudio | Stream.open 增加参数 screenAudio。 |
废弃 API
无
4.2.1 (2021-05-17)
改进了音频通信质量。
4.2.0 (2021-05-12)
网易云信于 2021 年 5 月 12 日发布了 NERTC SDK 最新版本 V4.2.0。
新增特性
| 序号 | 新增特性 | 特性描述 | 相关文档 |
|---|---|---|---|
| 1 | 设置用户媒体流优先级 | 支持设置本地用户的媒体流为优先级。如果某个用户的优先级为高，那么该用户媒体流的优先级就会高于其他用户，弱网环境下 SDK 会优先保证其他用户收到的、高优先级用户的媒体流的质量。 | setLocalMediaPriority |
| 2 | 画布水印功能 | 视频画布中支持添加文字水印、时间戳水印和图片水印，适用于信息安全、版权声明、防伪、宣传等场景。 | 水印 |
改进优化
优化戴耳机场景下回声和双讲卡顿效果。优化耳返的延时，从 300ms 降低到 80ms。
问题修复
修复蓝牙耳机音频通话被系统电话打断后，无法恢复到蓝牙耳机的问题。
新增 API
| API | API 说明 |
|---|---|
| Client.setLocalMediaPriority | 设置本地用户的媒体流优先级。 |
| Stream.setCanvasWatermarkConfigs | 添加视频画布水印。 |
变更 API
无
废弃 API
无
4.1.1 (2021-04-30)
优化媒体订阅的内部流程。
4.1.0 (2021-04-07)
网易云信于 2021 年 4 月 7 日发布了 NERTC SDK 最新版本 V4.1.0。
新增特性
| 序号 | 新增特性 | 特性描述 | 相关文档 |
|---|---|---|---|
| 1 | 支持双人通话的独立场景 | NERTC 在 V4.1.0 版本中提供了更加适合双人房间场景的底层策略，优化双人房间时的音视频质量效果。双人通话功能适用于点对点通话的业务场景。 | 双人通话 |
| 2 | 自定义音频渲染 | NERTC SDK 支持自定义音频采集与渲染功能，可以向 NERTC SDK 提供自定义的音频输入源数据，使用自定义的渲染器，并由 NERTC SDK 进行编码推流。 | 自定义音频渲染 |
| 3 | Web 端支持视频辅流形式的屏幕共享 | Web 端支持通过辅流形式实现屏幕共享，单独为屏幕共享开启一路上行的视频流，摄像头的视频流作为主流，屏幕共享的视频流作为辅流，两路视频流并行，同时上行摄像头和屏幕两路画面。 | 屏幕共享 |
| 4 | NERTC Restful API 支持用房间名称（cname）发起调用 | 音视频通话和互动直播场景的服务端 API 通过新 URL 的方式支持使用房间名称发起调用，同时原 URL 及调用方式仍旧保留以保证新老兼容。 | API 概览 |
改进优化
| 序号 | 新增功能 | 功能描述 |
|---|---|---|
| 1 | 优化音视频大房间的表现效果 | 客户端上实现音频选路策略 ASL，在大房间的场景中降低客户端上性能消耗，来提升客户端上能支持的用户连接上限。配合级联服务器的使用，可以将房间内并发人数提升到万人。详细说明请参考 大房间使用说明。 |
| 2 | 视频引擎优化 | 支持视频 AI 超分，通过机器学习等 AI 算法，改善因受限于网络带宽限制或实时性的要求导致视频分辨偏低的问题，实现低分辨率视频在传输后进行细节补充的效果以优化接收端的视频清晰度，从而提升用户体验。 |
新增 API
| API | API 说明 |
|---|---|
| stream.muteScreen() | 开启发送屏幕共享流。 |
| stream.unmuteScreen() | 停止发送屏幕共享流。 |
变更 API
| API | API 说明 |
|---|---|
| remoteStream.setSubscribeConf | 新增 `screen` 属性，可设置是否订阅屏幕共享流。 |
| remoteStream.takeSnapshot(options) | 新增 `mediaType` 属性，可指定为 `video` 或 `screen`。 |
| localStream.setLocalRenderMode(options, mediaType) | 新增 `mediaType` 参数，可指定为 `video` 或 `screen`。 |
| remoteStream.setRemoteRenderMode(options, mediaType) | 新增 `mediaType` 参数，可指定为 `video` 或 `screen`。 |
| remoteStream.startMediaRecording(options) | 新增选项 `screen`，可录制屏幕共享+声音。 |
| Stream.open(options) | 新增选项 `screen`，用于在通过过程中打开屏幕共享。 |
| Stream.close | 新增选项 `screen`，用于在通过过程中关闭屏幕共享。 |
| client.join | 新增 `mode`，可设置为 1v1，用于开关 1v1 能力。 |
废弃 API
无
4.0.1 (2021-03-02)
问题修复
修复偶现的鉴权异常问题。
4.0.0 (2021-02-24)
网易云信于 2021 年 2 月 24 日发布了 NERTC SDK 最新版本 V4.0.0，在音视频能力和性能方面均有显著优化。从 V4.0.0 版本开始，NERTC 在 Web 平台的抗丢包能力提升到 70%，支持在旁路推流时设置单路透传和音频编码配置。
改进优化
| 新增功能 | 功能描述 |
|---|---|
| Web 端 Qos 优化 | 纯音频场景下，Web 端的上下行网络在丢包率 70% 时仍可保证正常通话。 |
API 变更
| API | API 说明 |
|---|---|
| addTasks | 创建推流任务。rtmpTasks 增加 config 结构体，用于配置音视频流属性。 |
| updateTasks | 更新推流任务。rtmpTasks 增加 config 结构体，用于配置音视频流属性。 |
3.9.1 (2021-01-18)
新增
适配移动端 H5 上音视频效果，支持 iOS 13+ Safari 浏览器、Android 微信浏览器。
3.9.0 (2021-01-08)
新增
- Web 端支持主动获取网络连接状态。
- 直播模式下支持设置房间角色。
技术优化
- 支持全新的网易自研 NEVC 编码协议，具有相较于开源的 AVC 和 HEVC 更优越的性能，同等码率下提升视频整体清晰度，提高鲁棒性和错误恢复能力，优化用户的视频感官体验。
- 屏幕共享画面优化，提升静态共享画面的清晰度，优化用户体验。
- 支持暗场景视频图像增强，优化暗场景下的通话体验。
3.8.2 (2020-12-29)
改动
- 流程优化
3.8.1 (2020-12-04)
新增
- 房间连接状态通知功能
- 自定义音频、视频输入
3.7.0 (2020-09-28)
改动
- setScreenProfile 接口：增加分辨率的配置
3.6.0 (2020-08-20)
新增
-
getSystemStats 接口：获取系统信息
-
getTransportStats 接口：获取网络类型和网络连接状况统计数据
-
getSessionStats 接口：获取与当前会话相关的统计数据
-
getLocalAudioStats 接口：获取本地发布流的音频统计数据
-
getLocalVideoStats 接口：获取本地发布流的视频统计数据
-
getRemoteAudioStats 接口：获取远端订阅流的音频统计数据
-
getRemoteVideoStats 接口：获取远端订阅流的视频统计数据
-
connection-state-change 回调: 通知 SDK 的连接状态
-
exception 回调: 通知房间内的异常事件。异常事件不是错误，但是往往会引起通话质量问题
-
setChannelProfile 接口：设置房间模式
3.5.0 (2020-06-23)
新增
-
新增自定义视频数据输入功能。
-
新增互动直播操作接口
-
新增互动直播状态回调接口
-
互动直播支持占位图片的能力
-
safari 13+浏览器的支持
变更
- 弃用通话模式设置，统一为多人会议场景。
- 弃用 create API 接口
3.4.0 (2020-04-28)
新增
-
新增互动直播推流功能。
-
新增网络状态回调。
3.3.0 (2020-03-31)
新增
-
新增音频场景设置。
-
新增音频数据回调。
-
新增屏幕共享场景设置。
3.2.0 (2020-01-15)
-
支持多人会议功能。
-
支持订阅功能。
-
支持音视频通话功能。
-
设备检测功能。
-
新增屏幕共享功能。
-
新增云端伴音功能。
-
新增播放控制。
-
新增声音音量控制。
-
新增视频截图功能。
-
新增客户端录制功能。
