3.44.7

该版本于 2022 年 12 月 12 日发布。
修复了一些缺陷。

3.44.1

该版本于 2022 年 9 月 23 日发布。
在这个版本中,Electron 端的接口与能力和 Windows 端 3.44.0 保持高度一致。
和之前的 Beta 版本相比,有以下改进。

新增特性

支持创建多个房间实例,本地用户可同时加入多个房间,订阅不同房间中的媒体流。为此,多个 API 和回调参数增加了 roomId 参数,详见 升级指南。

媒体处理
  1. 支持根据业务场景需要选择合适的音质档位,具体参看音频属性。

  2. 支持本地采集画面在编码传输时做镜像处理,使远端用户与本地用户看到的本地画面一致,具体功能实现参看镜像。

网络
  1. 支持音视频通话前进行网络质量检测,具体参看:通话前网络检测。

  2. 支持在音视频通话前进行通话回路测试,包括对音视频采集/播放设备,以及上下行网络的测试,以便在通话开始前确认设备可用性及音视频流回路是否通畅,保证通话链路的整体连通性,具体参看:startEchoTest。

  3. 支持通过 onNetworkQuality 回调监测本端和已订阅用户的网络质量评分,详见通话质量监测。

媒体设备管理
  1. 新增本地音频采集和播放设备测试功能,在通话前进行录音和播放测试,确保通话顺利进行。或者在通话中遇到无声问题时,发起音频设备检测,快速排查和定位问题。具体参看 startAudioPlaybackDeviceTest

  2. 支持音频播放和采集路由跟随系统的路由设置。参看 followSystemPlaybackDevice 和 followSystemCaptureDevice。

  3. 当通话被系统电话、锁屏或合盖等打断时,支持暂停采集音视频,并在打断结束后自动恢复。具体参看通话打断和恢复。

  4. 发流端同时使用两个设备分别采集音频和视频时,支持设置音画同步,具体参看 setMultiDeviceAVSync。

混音
  1. 支持调整音视频通话中使用的音频文件的播放速度,参看 setAudioMixingPlaybackSpeed。

  2. 增强混音功能,支持在线音频文件混音,参看 startAudioMixing。

  3. 支持对混音伴奏或人声进行升降调调节,具体参看 setAudioMixingPitch, setLocalVoicePitch。

  4. 支持周期性回调混音伴奏播放进度,具体参看 setAudioMixingProgressInterval。

  5. 支持获取混音音频文件音轨索引,并指定当前音频文件的播放音轨,具体参看 getAudioTrackCount, selectAudioTrack。

  6. 在播放 PCM 音频数据时,支持调节音量。具体参看setAudioMixingVolume。

  7. 支持对音乐文件的声道进行设置,具体参看 API 文档:setAudioMixingDualMonoMode

高级功能
  1. 向所有用户提供包括美白、磨皮、锐化的基础美颜功能,无需额外鉴权。基础美颜接口不能与高级视频特效接口共用,如已购买高级视频特效,建议调用原接口使用高级特效、贴纸功能等。具体参看:enableEffectBeauty 和 setBeautyIntensity。

  2. 支持范围语音能力,同一房间中设定范围内的音源音量随距离增加呈衰减效果,可根据场景需要,选择音量根据距离线性衰减或非线形衰减。音量随距离增大进行非线性衰减更符合真实世界中声音的表现。具体参看范围语音文档。使用该功能需持有 Room 对象。

  3. 大会模式和音频选路功能正式上线。支持容纳高达千人的音视频互动。功能详细介绍和使用信息参看大会模式和音频选路。

  4. 在 RTC 客户端向应用服务端发送实时消息时,可以通过相应回调获取来自应用服务端的 response 消息。详见 onServerMessageSendResult。

  5. 支持视频水印功能,详见 setVideoWatermark。

  6. 支持单个用户在同一房间内发起多个转推直播任务,具体参看 API 文档:startLiveTranscoding

  7. 收到用户离开房间回调 onUserLeave 时,支持区分用户主动离房行为和用户切换隐身身份。

  8. 支持通过 onActiveSpeaker 获取房间内最活跃用户(Active Speaker)的信息。本地和远端音量回调(onLocalAudioPropertiesReport 和 onRemoteAudioPropertiesReport )支持同时返回线性和非线性音量值。支持通话前音量检测。

  9. 支持跨房间推拉流能力,具体参看跨房间转发媒体流

  10. 支持进行人声提示(VAD)和音频频谱检测。具体参看enableAudioPropertiesReport。

  11. 新增美声和混响特效,支持改变通话音频声色和音效,具体参看 API 文档:setVoiceChangerType。

  12. 支持多房间模式下端云一体转推直播。

功能优化
基础功能
  1. 重新设计媒体流的控制接口,实现了摄像头/麦克风采集的媒体流与屏幕共享媒体流的分离控制,同时支持灵活控制媒体流的发布/取消发布、订阅/取消订阅,具体接口变更参看升级指南。

  2. 优化视频大小流的发布订阅流程,发布端开启发送多路流模式后,订阅端可自行设置期望订阅的视频参数,由发布端根据订阅端的设置自动匹配参数相近的流进行发送,具体参看 推送多路流。

  3. 丰富性能回退场景下视频的降级档位,具体参看性能回退。

  4. 支持视频采集和编码参数分开设置,详见 setVideoCaptureConfig。本地视频采集支持设置采集模式,包括自动设置采集参数(默认)、手动设置采集参数、与编码参数保持一致三种模式供用户灵活配置,具体参看 VideoCaptureConfig。默认模式采集的本地预览视频清晰度和帧率较之前版本均有提高,但在美颜特效等场景下性能会受一定影响,如若介意,则将采集模式设置为与编码参数保持一致即可。

  5. 屏幕采集回调中清晰定义启动、暂停、恢复、错误、停止五个状态,使用户能够通过回调感知采集状态变化,并进行相应操作,具体参看 startScreenVideoCapture。支持纯音频场景下,通过屏幕流进行信息同步。

  6. 提升了视频帧格式转换的效率。

  7. 增加进房参数校验,并统一进房相关错误提示。

媒体处理
  1. 提升音频属性设置接口易用性,丰富了音频场景 roomProfile 和音质选项 AudioProfileType,满足更多不同场景的需要。 roomProfile 既可以在客户端设置,也可以通过配置下发。在选定的音频场景 roomProfile 基础上,调用 AudioProfileType 切换音质档位。

  2. 优化视频采集模块,提升逆光、纯色光下白平衡和曝光准确度。

媒体设备管理
  1. 增强了 PC 端的音视频设备管理能力,提供了更多设备信息,例如是设备连接类型,是否为虚拟设备等。新增部分为对原有逻辑的扩展,之前使用方式不受影响。
高级功能
  1. 细化了转推直播的任务状态回调,具体参看:onStreamMixingEvent。优化服务端合流转推的默认音频参数。扩展了转推直播配置参数结构体,支持图片合流。可以通过 startLiveTranscoding 和 updateLiveTranscoding 进行设置。

  2. 房间内点对点消息、房间外点对点消息、房间广播消息均支持超低延时传输。

  3. 优化现有空间音频功能,在游戏的小队模式中支持开启空间音频。提升了空间音频的朝向体验。在通话过程中,RTC 将根据通话用户各自的朝向渲染音频,收听者可以感受到发言者朝向改变带来的空间音频效果。具体参看空间音频。

缺陷修复
  1. 原 onFirstRemoteVideoFrameRendered 回调名称与行为不一致,回调时机为第一帧远端视频解码后渲染前。新版本中该回调改为于渲染成功后触发,而第一帧远端视频解码后渲染前改为触发 onFirstRemoteVideoFrameDecoded回调。

  2. 调用 joinRoom 加入房间时,由于 UserID、Token 等参数错误导致进房失败后,可以直接再次调用 joinRoom 重新发起进房,无需先调用 leaveRoom 离开房间后再进房。

(Beta) 1.4.0

该版本于 2022 年 7 月 19 日发布。

功能优化

屏幕共享能力扩展,增加了枚举共享对象缩略图、应用图标和应用名称等信息,用于对应用进行分类展示,方便用户选取屏幕共享对象,参见 getScreenCaptureSourceList。

(Beta) 1.3.0

首个正式发布版本,于 2022 年 6 月 9 日发布。
查看以下文档,快速接入 RTC Electron SDK。