更新日志(V5)

更新时间: 2024/04/09 11:30:46

本文介绍 NERTC SDK Android 端 V5.X 版本的更新日志。

近期重要更新

  • v5.5.40 开始,为方便开发者快速接入,SDK 新增多种预设场景。当前支持的预设场景包括:标准 1对1 音视频通话、高画质 1对1 音视频通话、标准语聊房、高音质语聊房、会议场景。

  • v5.5.32 开始,支持定制裁剪一些视频特效功能,减小包体积。

  • v5.5.10 开始,支持限定 RTC SDK 的访问区域。在出海场景中,满足客户在海外访问域名的合规性。


[5.5.40] - 2024-04-03

新增特性

  • 为方便开发者快速接入,SDK 新增多种预设场景。当前支持的预设场景包括:标准 1对1 音视频通话、高画质 1对1 音视频通话、标准语聊房、高音质语聊房、会议场景。
  • 支持初始化时指定 audio dump 路径。

改进优化

  • 优化 AI 降噪设置,提升降噪效果。
  • 支持自定义设置音频路由。

新增 API

接口/回调 接口/回调说明
setAudioProfile [1/2] 设置音频编码属性
setAudioScenario 设置音频编码属性的应用场景

变更 API

接口 变更说明
RTCChannelProfile 房间场景新增以下枚举值:
  • int STANDARD_VIDEOCALL = 3;
  • int HIGHQUALITY_VIDEOCALL = 4;
  • int STANDARD_CHATROOM = 5;
  • int HIGHQUALITY_CHATROOM = 6;
  • int MEETING = 7;
  • NERtcOption 新增 audioDumpDir 参数,用于初始化时指定 audio dump 路径。

    [5.5.32] - 2024-03-15

    改进优化

    • 优化音频编码传输策略,提升弱网和带限场景下的适应能力,降低设备功耗。
    • 优化音频 3A 算法,提升扬声器外放场景的交互音质。
    • 支持定制裁剪一些视频特效功能,减小包体积。

    新增 API

    接口/回调 接口/回调说明
    onLocalAudioFirstPacketSent 音频首帧发送回调

    [5.5.30] - 2024-02-29

    改进优化

    提升了自定义加密功能的易用性。

    [5.5.21] - 2024-01-18

    新增 API

    接口/回调 接口/回调说明
    NERtcPacketObserver 数据包回调 observer。
    isFeatureSupported 查询当前设备是否支持虚拟背景功能。

    变更 API

    接口 变更说明
    ErrorCode 新增以下枚举值:
  • int ENGINE_ERROR_JOIN_INTERRUPTED_DUE_TO_LEAVE_ACTION = 30028;
  • int ENGINE_ERROR_JOIN_INTERRUPTED_DUE_TO_DESTROY_ACTION = 30029;
  • int ENGINE_ERROR_JOIN_INTERRUPTED_DUE_TO_APP_TERMINATION = 30030;
  • NERtcEncryptionConfig 增加成员变量自定义加密回调 observer
    EncryptionMode 增加枚举自定义加密模式 EncryptionModeCustom
    NERtcFeatureType 增加枚举 NERtcFeatureType.VIRTUAL_BACKGROUND,功能类型为虚拟背景。

    改进优化

    • 提升安卓平台硬件视频编码的适配能力
    • 虚拟背景功能支持 MTK 芯片

    [5.5.12] - 2023-12-15

    改进优化

    修复小概率的音量回调不准确问题。

    [5.5.11] - 2023-12-05

    改进优化

    • 提升首次安装时的登录成功率。
    • 修复特定条件下小概率的房间角色错误问题。
    • 修复安卓端外部视频输入的预览镜像逻辑。
    • 提升语聊房场景的音频效果。
    • 适配安卓 14 系统,修复小部分机型的崩溃问题。
    • 提升稳定性。

    [5.5.10] - 2023-10-31

    升级必看

    如果您计划将应用中使用的旧版本 RTC SDK 从 V5.5.2 升级为当前版本,请根据接口变更,更新相应的代码,具体请参考升级指南

    新增特性

    新增特性 特性描述 相关文档
    范围语音 在一个 RTC 房间内,用户可以与一定距离内的其他用户进行实时语音通话,支持“仅小队”或“所有人”的语音模式。它可以让玩家在游戏中实时交流,从而更好地协调战术和策略。 范围语音
    音频推拉流的黑白名单 您可以设置推流白名单、拉流白名单或拉流黑名单,从而实现只推流给指定用户或只订阅指定用户的音频,以便满足游戏语音等场景下的需求。 设置音频转发路由
    限定访问区域 为满足客户在海外访问域名合规性,云信支持访问区域限制功能。无论用户身处何地使用 App,SDK 都只会访问指定区域的域名。 限定 RTC SDK 的 访问区域

    新增API

    接口/回调 接口/回调说明
    initSpatializer 初始化空间音效。
    setAudioRecvRange 设置空间音效的距离衰减属性和语音范围。
    setRangeAudioTeamID 设置范围语音的队伍号。
    setRangeAudioMode 设置范围语音的模式。
    setSubscribeAudioAllowlist 设置只订阅指定用户的音频流。
    setSubscribeAudioBlocklist 设置不订阅指定用户的音频流。
    onFirstVideoFrameRender 已接收到远端视频首帧并完成渲染的回调。
    onAudioHasHowling 啸叫消失的回调。
    setCallbackHandler 若您的业务系统想要接入并获取 SDK 的统计数据,您可以根据需要调用该接口修改回调事件的队列线程。
    onLabFeatureCallback 定制功能回调,建议空实现。如有需要请联系技术支持。

    变更 API

    接口/回调 变更说明
    NERtcDistanceRolloffModel 空间音效的距离衰减模式新增kNERtcDistanceRolloffLinearOnly(3)选项,表示仅线性衰减,没有方位效果
    setAudioRecvRange 接口名称修改,对应的原接口名称为 UpdateSpatializerAudioRecvRange
    updateSelfPosition 接口名称修改,对应的原接口名称为 UpdateSpatializerSelfPosition
    enableSpatializer 接口名称修改(接口首字母改为小写),新增 applyToTeam 参数。
    NERtcPositionInfo 结构体名称修改,对应的原结构体名称为 NERtcSpatializerPositionInfo
    NERtcOption 新增 areaCodeType 参数,用于限定访问区域。
    onAudioHasHowling 原先只有检测到啸叫时会触发 onAudioHasHowling(true)回调,V5.5.10 版本新增当啸叫消失时,也会触发 onAudioHasHowling(false)回调。
    NERtcVideoConfig 删除摄像头位置参数 frontcamera

    改进优化

    • 优化断网重连之后音画同步效果。
    • 优化弱网场景入会时长和首帧耗时。
    • 画质不变情况下,降低视频码率和性能开销。
    • 优化音乐场景下回声消除和降噪效果。

    [5.5.2] - 2023-10-07

    改进优化

    • 优化信令连接,提高在 UDP 不通情况下的入会速度和成功率。
    • 优化信令数据,提高入会速度。

    [5.5.0] - 2023-08-29

    改进优化

    • 优化 SDK 的包体积大小

    • 优化 SDK 的首帧耗时

    • 优化 ne264 编码器,提升弱网场景的视频体验

    • 优化视频 pipeline,提升中低端手机的视频流畅度

    • 虚拟背景功能适配更多机型

    • 优化 Android 硬件编解码,适配更多设备

    • 视频水印功能支持所有设备和平台

    • 虚拟背景和视频水印功能启用硬件分级策略

    • 针对低性能设备,提供更加稳定的音频质量

    • 在 Music 场景,声音外放时,优化回声消除效果

    • 针对噪声和回声处的音量放大做适当控制

    • 支持华为 AudioKit

    [5.4.9] - 2023-09-12

    新增特性

    • 外接摄像头时,支持多摄像头切换。
    • camera 1 支持外接摄像头的动态热插拔。

    [5.4.8] - 2023-08-29

    问题修复

    • 修复鸿蒙手机偶现的异常问题。

    • 修复部分已知问题。

    [5.4.7] - 2023-08-09

    问题修复

    修复部分已知问题。

    [5.4.3] - 2023-07-27

    改进优化

    音频 opus 编码器支持 24kHz 采样率。

    问题修复

    修复部分已知问题。

    [5.4.1] - 2023-07-18

    新增API

    接口/回调 接口/回调说明
    onRemoteVideoSizeChanged 远端视频分辨率变化的回调。
    onLocalVideoRenderSizeChanged 本地视频预览分辨率变化的回调。

    问题修复

    修复部分已知问题。

    [5.4.0] - 2023-07-04

    新增特性

    新增特性 特性描述 相关文档
    空间音效 空间音效也称 3D 音效,是通过在音频信号中添加空间信息,使得听众可以感受到声音来自于特定的位置和空间环境。它可以增强音频的真实感和沉浸感,让听众感受到更加真实的声音效果。 空间音效

    新增API

    接口/回调 接口/回调说明
    EnableSpatializer 开启/关闭空间音效。
    UpdateSpatializerAudioRecvRange 设置空间音效的距离衰减属性和语音范围。
    SetSpatializerRoomProperty 设置房间混响属性。
    EnableSpatializerRoomEffects 开启或关闭空间音效的房间混响效果。
    UpdateSpatializerSelfPosition 设置说话者和接收者的位置信息。
    SetSpatializerRenderMode 设置渲染模式。
    NERtcExternalVideoRenderer.setLocalExternalVideoRenderer 自定义本地视频渲染器。
    NERtcExternalVideoRenderer.setRemoteExternalVideoRenderer 自定义远端视频渲染器。

    改进优化

    • AI 降噪能力优化。

      提升了人声音质和降噪量,有效地抑制各种噪声而不会损伤人声。在教育和会议场景中,它针对人声(如小孩声和笑声)做了保护,避免这些声音被过度抑制。

    • 优化 AEC 算法,重点改进本端和远端双讲时的效果。

      可在双讲场景下保存清晰、流畅的近端人声,为用户在会议、语聊等场景下提供更舒适的通话体验。

    • 通过优化音频 NACK 请求,降低音频在弱网环境下的端到端延时。

    • 在弱网环境下优化首帧耗时。

    • 改善极端弱网环境下的视频清晰度。

    • 优化包大小。

      V5.4.0 版本开始,默认支持 vp8 编解码能力,不再支持 vp9 编解码能力,在保障客户端与 Web 端互通能力的同时,减小包体大小。

    • Android 硬件编解码适配。

      Android 默认使用camera2,提升摄像头的图像采集质量。同时加强了硬件功能和编解码质量的稳定性,可支持更多的手机设备。

    • 优化 NE264 编码器。

    • 提升低端手机的发送帧率。

      改善了低端机上前处理的帧率,及性能受限情况下的编码稳定性,低端机上可提升视频发送帧率。

    • 当用户未赋予 BLUETOOTH_CONNECT 权限时,支持使用手机麦克风采集声音。

    [5.3.11] - 2023-08-16

    问题修复

    修复部分已知问题。

    [5.3.8] - 2023-07-21

    问题修复

    修复部分已知问题。

    [5.3.7] - 2023-06-16

    问题修复

    修复部分已知问题。

    [5.3.6] - 2023-06-02

    问题修复

    • 修复安卓 SDK 在特定场景下部分回调不生效的问题。
    • 修复部分已知问题。

    [5.3.5] - 2023-05-24

    新增特性

    支持纯音频 SDK。请通过网易云信 SDK 下载中心下载纯音频的 SDK 包。

    问题修复

    修复部分已知问题。

    [5.3.3] - 2023-05-15

    新增特性

    新增特性
    特性描述
    相关文档
    调节本地播放的指定房间内所有远端用户的音量。 在多房间场景中,可以使用该方法单独调整主房间或者某个子房间的所有远端用户的播放音量。 设置通话音量

    问题修复

    修复部分已知问题。

    [5.3.1] - 2023-05-05

    网易云信于 2023 年 5 月 5 日正式发布 NERTC SDK V5.3.1 版本。该版本提供统一的业务需求实现和更友好的跨平台接入支持,并以更小的包体积帮助您实现快速接入。

    升级必看

    如果您计划将应用中使用的旧版本 RTC SDK 从 V4.6.X 升级为当前版本,请根据接口变更,更新相应的代码,具体请参考升级指南

    新增特性

    新增特性 特性描述 相关文档
    插件化集成人脸增强、视频超分、视频降噪功能 支持通过插件化集成人脸增强、视频超分、视频降噪功能,提升 SDK 集成的灵活性与易操作性,减小 App 的包体积。 集成 SDK
    本地数据通道 支持通过本地数据通道传输除音频、视频数据之外的其他数据。例如传输游戏数据、传输传感器数据等。 不涉及
    子房间功能优化 支持自定义视频采集、设置房间中用户音量实时回调、切换前后置摄像头。 多房间管理
    麦克风关闭时发伴音 支持用户在麦克风关闭时,发送伴音。 音效与伴音

    改进优化

    • 支持非主播角色成员或在连接异常状态下,删除推流任务。
    • 支持通过不同的 uid 进入子房间。
    • 支持日志加密默认开启。
    • 各端对齐日志的内容、文件命名和默认存放路径。Android 端的默认日志路径为:sdcard/Android/data/your_app_name/files/rtc_log

    新增API

    接口/回调 接口/回调说明
    enableLocalData 开启或关闭本地数据通道。
    subscribeRemoteData 取消或恢复订阅指定远端用户数据通道流。
    sendData 通过数据通道发送数据。
    onUserDataStart 远端用户通过数据通道发送数据的回调。
    onUserDataStop 远端用户停用数据通道的回调。
    onUserDataReceiveMessage 远端用户通过数据通道接收数据的回调。
    onUserDataStateChanged 远端用户数据通道使用状态改变通知回调。
    onUserDataBufferedAmountChanged 远端用户数据通道待传输数据量改变通知回调。

    变更 API

    接口/回调 变更说明
    setLocalVideoWatermarkConfigs NERtcVideoWatermarkTextConfigNERtcVideoWatermarkTimestampConfig 结构体里的 fontPath 名字改为 fontNameOrPath
    NERtcLocalVideoWatermarkState 删除了 kNERtcLocalVideoWatermarkStateFontPathEmpty 这个state。
    RemoveLiveStreamTask 接口的调用时机变更,支持在不加入房间的状态下调用该接口,以便用户在切换角色之后、ondisconnect 等异常情况下删除推流任务。
    switchCameraWithPosition 调用 enableLocalVideo() 接口进行本地视频采集与发送时,采集的摄像头行为变更,由之前的延用上一次摄像头配置,改为默认采用switchCameraWithPosition 接口中指定的前置摄像头或后置摄像头。

    功能下线

    V5.3.0 及之后版本不再支持 画布水印(setLocalCanvasWatermarkConfigs 和 setRemoteCanvasWatermarkConfigs) 功能,统一使用编码水印(setLocalVideoWatermarkConfigs)。编码水印可以从源头保证数据的真实性,具体请参见水印

    此文档是否对你有帮助?
    有帮助
    去反馈
    • 近期重要更新
    • [5.5.40] - 2024-04-03
    • 新增特性
    • 改进优化
    • 新增 API
    • 变更 API
    • [5.5.32] - 2024-03-15
    • 改进优化
    • 新增 API
    • [5.5.30] - 2024-02-29
    • 改进优化
    • [5.5.21] - 2024-01-18
    • 新增 API
    • 变更 API
    • 改进优化
    • [5.5.12] - 2023-12-15
    • 改进优化
    • [5.5.11] - 2023-12-05
    • 改进优化
    • [5.5.10] - 2023-10-31
    • 升级必看
    • 新增特性
    • 新增API
    • 变更 API
    • 改进优化
    • [5.5.2] - 2023-10-07
    • 改进优化
    • [5.5.0] - 2023-08-29
    • 改进优化
    • [5.4.9] - 2023-09-12
    • 新增特性
    • [5.4.8] - 2023-08-29
    • 问题修复
    • [5.4.7] - 2023-08-09
    • 问题修复
    • [5.4.3] - 2023-07-27
    • 改进优化
    • 问题修复
    • [5.4.1] - 2023-07-18
    • 新增API
    • 问题修复
    • [5.4.0] - 2023-07-04
    • 新增特性
    • 新增API
    • 改进优化
    • [5.3.11] - 2023-08-16
    • 问题修复
    • [5.3.8] - 2023-07-21
    • 问题修复
    • [5.3.7] - 2023-06-16
    • 问题修复
    • [5.3.6] - 2023-06-02
    • 问题修复
    • [5.3.5] - 2023-05-24
    • 新增特性
    • 问题修复
    • [5.3.3] - 2023-05-15
    • 新增特性
    • 问题修复
    • [5.3.1] - 2023-05-05
    • 升级必看
    • 新增特性
    • 改进优化
    • 新增API
    • 变更 API
    • 功能下线