3.0.0及以上版本升级指南
2023-09-25
注意
- 如果您当前的 SDK 低于 3.0.0 版本，需要升级到任一 3.0.0 或以上的 SDK 版本时，都请务必阅读本文。
- 此外，建议您根据当前版本号与升级目标版本号，参考 发布日志 中两个版本区间的变更说明，检查您的业务相关接口。
本文将介绍 Express SDK 版本升级至 3.0.0 及以上版本时的说明和注意事项。
废弃说明
-
废弃 ZegoScenario 场景枚举中的
General、Communication、Live三种场景，请参考 场景化音视频配置 文档进行适配。 -
从 3.0.0 版本开始，Express iOS SDK 不再支持 bitcode，详情请参考 Xcode 14 Release Notes 中关于废弃 bitcode 的说明。
说明适配方式：打开 Xcode 工程的配置页面，在 App Target 的 "Build Settings" 页面中找到 "Enable Bitcode" 选项，将其设置为 "No"。
-
废弃了 ZegoEngineConfig > advancedConfig 的配置项 "audio_device_mode"，请使用 setAudioDeviceMode 接口代替。
删除说明
删除下列在先前版本已废弃的接口。
| 方法名 | 描述 |
|---|---|
| setDebugVerbose | 设置调试详细信息开关以及语言。此函数在 2.3.0 版本废弃，请使用 enableDebugAssistant 来实现原来的功能。 |
| loginMultiRoom | 登录多房间。此方法在版本 2.9.0 以后已废弃，若需实现多房间功能，请先在引擎初始化之前调用 setRoomMode 函数设置多房间模式，再使用 loginRoom 登录多房间，如果调用 loginRoom 函数登录多房间，请确保传入相同的用户信息。 |
| setPlayStreamVideoLayer | 设置选取拉流视频图层。此函数在 2.3.0 版本以后已废弃, 请使用 setPlayStreamVideoType 代替。 |
| enableAudioDataCallback | 开启额外接收音频数据的回调。此函数在 2.7.0 版本以后已废弃，请使用 startAudioDataObserver 和 stopAudioDataObserver 代替。 |
| setReverbParam | 设置混响的具体参数。此函数在 1.18.0 版本以后已废弃，请使用 setReverbPreset 或者 setReverbAdvancedParam 代替。 |
| setBuiltInSpeakerOn | 是否使用内置扬声器播放声音。此函数在 2.3.0 版本以后已废弃，请使用 setAudioRouteToSpeaker 代替。 |
| onRoomStreamUpdate | 相同房间内其他用户推的流增加或减少的通知。此回调函数自 1.18.0 起已废弃，请使用带 [extendedData] 参数的 onRoomStreamUpdate 函数。 |
| onDeviceError | 设备异常通知。此函数在 2.15.0 3.0.0 版本及以上已废弃，请使用 onLocalDeviceExceptionOccurred 代替。 |
| onNetworkQuality | 回报房间中流的网络质量。此回调函数在 2.10.0 3.0.0 版本及以上已废弃，请使用带 ZegoStreamQualityLevel 枚举参数的 onNetworkQuality 函数。 |
| onProcessCapturedAudioData | 自定义音频处理本地采集 PCM 音频帧回调。此回调函数在 2.13.0 3.0.0 版本及以上已废弃，请使用带 [timestamp] 参数的 onProcessCapturedAudioData 函数。 |
| onProcessRemoteAudioData | 自定义音频处理远端拉流 PCM 音频帧回调。此回调函数在 2.13.0 3.0.0 版本及以上已废弃，请使用带 [timestamp] 参数的 onProcessRemoteAudioData 函数。 |
| onProcessPlaybackAudioData | 自定义音频处理 SDK 播放音频的 PCM 音频帧回调。此回调函数在 2.13.0 3.0.0 版本及以上已废弃，请使用带 [timestamp] 参数的 onProcessPlaybackAudioData 函数。 |
变更示例代码
您可以参考以下示例代码进行接口变更。