Upgrade Guide for Version 3.0.0 and Above
- If your current SDK version is lower than 3.0.0 and you need to upgrade to any SDK version 3.0.0 or above, please be sure to read this article.
- In addition, it is recommended that you check the interfaces related to your business by referring to the change descriptions between the two version intervals in Release Notes based on the current version number and upgrade target version number.
This article will introduce the instructions and precautions when upgrading the Express SDK to version 3.0.0 and above.
Deprecation Notice
-
Deprecate the three scenarios
General,Communication, andLivein the ZegoScenario scenario enumeration. Please refer to the Scenario-based Audio and Video Configuration documentation for adaptation. -
Starting from version 3.0.0, Express iOS SDK no longer supports bitcode. For details, please refer to the description about deprecating bitcode in Xcode 14 Release Notes.
Adaptation method: Open the configuration page of the Xcode project, find the "Enable Bitcode" option in the "Build Settings" page of the App Target, and set it to "No".
Deletion Notice
The following interfaces that were deprecated in previous versions have been deleted.
| Method Name | Description |
|---|---|
| SetDebugVerbose | Set debug verbose switch and language. This function was deprecated in version 2.3.0. Please use EnableDebugAssistant to implement the original functionality. |
| LoginMultiRoom | Login to multiple rooms. This method was deprecated after version 2.9.0. If you need to implement multi-room functionality, please call the SetRoomMode function to set multi-room mode before engine initialization, then use LoginRoom to login to multiple rooms. If calling LoginRoom to login to multiple rooms, please ensure that the same user information is passed in. |
| SetPlayStreamVideoLayer | Set the selection of playing stream video layer. This function was deprecated after version 2.3.0. Please use SetPlayStreamVideoType instead. |
| EnableAudioDataCallback | Enable callback to receive additional audio data. This function was deprecated after version 2.7.0. Please use StartAudioDataObserver and StopAudioDataObserver instead. |
| SetBuiltInSpeakerOn | Whether to use built-in speaker to play sound. This function was deprecated after version 2.3.0. Please use SetAudioRouteToSpeaker instead. |
| OnDeviceError | Device exception notification. This function was deprecated in version 2.15.0 and above. Please use OnLocalDeviceExceptionOccurred instead. |
Change Example Code
You can refer to the following example code for interface changes.