升级指南

更新时间: 2024/09/18 16:26:13

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

V5.5.10

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

接口名称变更

功能 原接口 新接口 集成修改建议
设置空间音效的距离衰减属性和语音范围 UpdateSpatializerAudioRecvRange setAudioRecvRange 若您使用了空间音效功能,请修改代码中对应的接口名称。
设置空间音效中说话者和接收者的空间位置信息 UpdateSpatializerSelfPosition updateSelfPosition
空间位置信息 NERtcSpatializerPositionInfo NERtcPositionInfo 若您使用了空间音效功能,请修改代码中对应的结构体名称。

接口行为变更

变更描述 集成修改建议
切换房间(switchChannel)。 在直播场景中,原先只支持观众切换房间,修改为主播和观众都支持切换房间,并且切换后会保持切换前的音视频的状态。 请检查房间切换前后的音视频状态是否符合预期。
onFirstVideoFrameDecoded 回调的触发时机修改,当重新调用 enableLocalVideo 开启本地视频采集,或停止屏幕共享后再重新调用 startScreenCapture 接口共享屏幕时,都会触发该回调。 不影响

V5.3.1

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

接口行为变更

序号 变更描述 集成修改建议
1 支持在不开麦的状态下开启伴音功能。 若您在 setParameters 中设置了不开麦状态下开启伴音功能(kNERtcKeyAudioMixSendEnabledWithoutMic),请删除相关代码片段即可。
2 观众调用 addLiveStreamTask 方法添加房间推流任务,无需跟服务器进行信令交互,直接返回 30005。 根据返回的 30005 错误码直接判断当前角色不正确。
3 设置画布缩放模式接口 setLocalRenderScaleMode/setRemoteRenderScaleMode 仅可在调用 setupLocalVideoCanvas/setupRemoteVideoCanvas 接口设置画布之后才生效。
4 日志的默认存放路径变更。 iOS 端的默认日志路径调整为:~/Documents/Logs

接口参数变更

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