Android
升级指南
更新时间： 2024/09/18 16:26:13
本文介绍 NERTC SDK V5.X 版本，Android 端升级的说明和注意事项。
V5.5.10
从 V5.5.2 升级至 V5.5.10 版本，涉及如下接口变更，您需要结合实际业务场景更新相关的 App 代码：
接口名称变更
| 功能 | 原接口 | 新接口 | 集成修改建议 |
|---|---|---|---|
| 设置空间音效的距离衰减属性和语音范围 | UpdateSpatializerAudioRecvRange |
setAudioRecvRange |
若您使用了空间音效功能，请修改代码中对应的接口名称。 |
| 设置空间音效中说话者和接收者的空间位置信息 | UpdateSpatializerSelfPosition |
updateSelfPosition |
|
| 启用空间音效 | EnableSpatializer |
enableSpatializer |
|
| 设置房间混响属性 | SetSpatializerRoomProperty |
setSpatializerRoomProperty |
|
| 开启或关闭空间音效的房间混响效果 | EnableSpatializerRoomEffects |
EnableSpatializerRoomEffects |
|
| 设置渲染模式 | SetSpatializerRenderMode |
setSpatializerRenderMode |
|
| 空间位置信息 | NERtcSpatializerPositionInfo |
NERtcPositionInfo |
若您使用了空间音效功能，请修改代码中对应的结构体名称。 |
接口行为变更
| 变更描述 | 集成修改建议 |
|---|---|
切换房间（switchChannel）。 在直播场景中，原先只支持观众切换房间，修改为主播和观众都支持切换房间，并且切换后会保持切换前的音视频的状态。 |
请检查房间切换前后的音视频状态是否符合预期。 |
onFirstVideoFrameDecoded 回调的触发时机修改，当重新调用 enableLocalVideo 开启本地视频采集，或停止屏幕共享后再重新调用 startScreenCapture 接口共享屏幕时，都会触发该回调。 |
不影响 |
V5.3.1
从 V4.6.X 升级至 V5.3.1 版本，涉及如下接口变更，您需要结合实际业务场景更新相关的 App 代码：
接口行为变更
| 变更描述 | 集成修改建议 |
|---|---|
| 支持在不开麦的状态下默认开启伴音功能。 | 若您在 setParameters 中设置了不开麦状态下开启伴音功能的开关(kNERtcKeyAudioMixSendEnabledWithoutMic)，删除相关代码片段即可。 |
观众调用 addLiveStreamTask 方法添加房间推流任务，无需跟服务器进行信令交互，直接返回 30005。 |
根据返回的 30005 错误码直接判断当前角色不正确。 |
关闭再开启本地视频采集后，采集的摄像头行为变更，由之前的延用上一次摄像头配置，改为默认采用switchCameraWithPosition 接口中指定的前置摄像头或后置摄像头。 |
若在房间内重新开启摄像头采集，请调用 switchCamera 方法重新选择所需要的前置或后置摄像头。 |
| 日志的默认存放路径变更。 | Android 端的默认日志路径调整为：sdcard/Android/data/your_app_name/files/rtc_log。 |
接口参数变更
| 变更描述 | 集成修改建议 |
|---|---|
编码水印 setLocalVideoWatermarkConfigs 接口中，NERtcVideoWatermarkTextConfig 和 NERtcVideoWatermarkTimestampConfig 结构体里的 fontPath 名字改为 fontNameOrPath。 |
若您使用了编码水印功能，请修改代码中对应的参数。 |
此文档是否对你有帮助？
