升级指南

更新时间: 2024/08/05 15:02:55

本文介绍 NERTC SDK V5.X 版本,Windows 端升级的说明和注意事项。

V5.3.1

从 V4.6.X 升级至 V5.3.1 版本,涉及如下接口变更,您需要结合实际业务场景更新相关的 App 代码:

接口行为变更

序号 变更描述 集成修改建议
1 支持在不开麦的状态下默认开启伴音功能。 若您在 setParameters 中设置了不开麦状态下开启伴音功能的开关(kNERtcKeyAudioMixSendEnabledWithoutMic),删除相关代码片段即可。
2 观众调用 addLiveStreamTask 方法添加房间推流任务,无需跟服务器进行信令交互,直接返回 30005。 根据返回的 30005 错误码直接判断当前角色不正确。
3 开启屏幕共享接口 startScreenCapture 与开启本地视频辅流通道接口 enableLocalVideo 互斥。
  • 如果当前正在屏幕共享,调用 enableLocalVideo 开启辅流时,需要调用stopScreenCapture 先停止屏幕共享。
  • 如果当前正在使用本地视频辅流通道进行本地摄像头采集或者外部自定义视频输入,调用 startScreenCapture 开启屏幕共享时,需要先调用enableLocalVideo停止辅流。
4 视频采集数据回调 onCaptureVideoFrame 默认关闭。 若您使用了视频采集数据回调功能,请先调用 setParameter(key:kNERtcKeyEnableVideoCaptureObserver) 方法开启此回调。
5 日志的默认存放路径变更。 Windows 端的默认日志路径调整为:EXE 同级目录下的 logs 文件夹,子目录的命名规则为AppKey 前6位_AppKey hash值的前 9 位。请根据新路径查找日志文件。

接口参数变更

序号 变更描述 集成修改建议
1 编码水印 setLocalVideoWatermarkConfigs 接口中,NERtcVideoWatermarkTextConfigNERtcVideoWatermarkTimestampConfig 结构体里的 fontPath 名字改为 fontName 若您使用了编码水印功能,请修改代码中对应的参数。
2 废弃 NERtcEngineContext 里的 log_file_max_size_KBytes 字段。 删除相关字段。
此文档是否对你有帮助?
有帮助
去反馈
  • V5.3.1