Common Error Codes

2025-01-21

1000xxx General Error Codes

General error codes are usually thrown from onRoomStateChanged, onPublisherStateUpdate, and onPlayerStateUpdate. Please handle them according to the following error codes.

Error Code Enumeration	Description
0	Execution successful
1000001	Description: Engine not initialized, cannot call non-static functions. Possible reason: Engine not created. Handling suggestion: Please call the [createEngine] function to create the engine first, then call the current function.
1000002	Description: Not logged in to room, function implementation not supported. Possible reason: Not logged in to room. Handling suggestion: Please call [loginRoom] to login to the room first, and use related functions during the online period after joining the room.
1000003	Description: Engine audio/video module not started, function implementation not supported. Possible reason: Engine audio/video module not started. Handling suggestion: Please call [startPreviewView] [startPublishingStream] [startPlayingStream] to start the audio/video module first.
1000006	Description: Calling a function not supported on the current system/platform. Possible reason: For example, calling a function to set Android context environment on a non-Android system. Handling suggestion: Check whether the system environment matches.
1000007	Description: Invalid Android context environment. Possible reason: Android context environment not set or set incorrectly. Handling suggestion: Set the correct Android context environment.
1000008	Description: `setEventHandler` has already been called to set a handler, please do not set it repeatedly. Possible reason: `setEventHandler` was called repeatedly to set a handler. Handling suggestion: If you need to set it repeatedly, please call `setEventHandler` to set the previous handler to null first.
1000010	Description: The current SDK does not support this function. Possible reason: The SDK version used does not include this function. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1000014	Description: Input StreamID is too long. Possible reason: The streamID parameter passed in when calling [startPublishingStream] or [startPlayingStream] exceeds the length limit. Handling suggestion: StreamID should be less than 256 bytes.
1000015	Description: Input StreamID is empty. Possible reason: The StreamID parameter passed in when calling [startPublishingStream] or [startPlayingStream] is a null pointer or an empty string. Handling suggestion: Check whether the streamID parameter passed in when calling the function is normal.
1000016	Description: Input StreamID contains illegal characters. Possible reason: The StreamID passed in when calling [startPublishingStream] or [startPlayingStream] contains illegal characters. Handling suggestion: Check whether the StreamID parameter passed in when calling the function is normal, only supports numbers, English characters, and "-", "_".
1000017	Description: Invalid input parameter. Possible reason: Parameter is null or parameter is an illegal value. Handling suggestion: Please enter the correct parameter.
1000018	Description: Input CDN URL is too long. Possible reason: The URL parameter passed in when calling [enablePublishDirectToCDN] or [startPlayingStream] exceeds the length limit. Handling suggestion: URL length should be less than 1024 bytes.
1000019	Description: Input CDN authentication parameter is too long. Possible reason: The CDN authentication parameter passed in when calling [enablePublishDirectToCDN] or [startPlayingStream] exceeds the length limit. Handling suggestion: Authentication parameter length should be less than 512 bytes.
1000020	Description: User ID or user name for logging in to room or logging in to scenario are not the same. Possible reason: Different user IDs or user names were passed in when logging in to room or scenario. Handling suggestion: Pass in the same user ID or user name when logging in to room or scenario.
1000037	Description: The AppID has been taken offline. Handling suggestion: Please check the status of the AppID in the ZEGOCLOUD Console, or contact technical support.
1000038	Description: Server backend configuration error. Possible reason: 1. Domain name configuration error; 2. Media network exception; 3. Media network link is empty. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1000039	Description: Server access denied. Possible reason: 1. The APP has enabled the restriction to prohibit access from IPs outside the domain, and the current client is outside the domain. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1000055	Description: CDN address error. Possible reason: The set CDN URL is not a standard RTMP or FLV protocol. Handling suggestion: Please check whether the protocol or format of the CDN URL is correct.
1000060	DNS resolution failed, please check network configuration. This error code has been deprecated.
1000065	Server scheduling exception, please contact technical support to resolve. This error code has been deprecated.
1000066	Description: Engine audio/video module already started, setting not supported. Possible reason: Only supports setting before starting the engine audio/video module. Handling suggestion: Please make settings before calling [startPreviewView] [startPublishingStream] [startPlayingStream] to start the audio/video module.
1000067	Description: Already logged in to room, setting not supported. Possible reason: Only supports setting before logging in to room. Handling suggestion: Please make settings before calling [loginRoom] to login to the room or after calling [logoutRoom] to logout of the room. Note that if you have logged in to multiple rooms, you need to logout of all rooms before making settings.
1000070	Description: Failed to load SDK dynamic library. Possible reason: The passed SDK dynamic path is incorrect. Handling suggestion: Please pass in the correct SDK dynamic library path.
1000071	Description: Failed to get SDK export function when loading SDK dynamic library. Possible reason: SDK dynamic library version mismatch. Handling suggestion: Please load the SDK dynamic library of the matching version.
1000072	Description: This call is not supported. Possible reason: ZEGOEXP_EXPLICIT macro not enabled. Handling suggestion: Please add ZEGOEXP_EXPLICIT macro in the preprocessor.
1000090	Description: SDK internal null pointer error. Possible reason: Android JVM environment exception. Handling suggestion: Please check whether the Android JVM environment is normal, or contact technical support.

Debugging phase error codes refer to errors that developers are prone to encounter during application development, usually manifested as interface parameter errors, etc. At this time, developers can obtain relevant error codes from callbacks such as onDebugError, onRoomStateChanged, onPublisherStateUpdate, and onPlayerStateUpdate.

Error Code Enumeration	Description
1001000	AppID cannot be 0, please check whether AppID is correct
1001001	Input AppSign length must be 64 bytes
1001002	Input AppSign contains illegal characters, only supports '0'-'9', 'a'-'f', 'A'-'F'
1001003	Input AppSign is empty
1001004	Description: Authentication failed. Possible reason: AppID is incorrect; incorrect environment used. Handling suggestion: Check whether the passed AppID matches the AppID in the ZEGOCLOUD Console; check whether the environment configured by the AppID matches the environment set by the SDK.
1001005	Description: Authentication failed. Possible reason: AppSign is incorrect. Handling suggestion: Check whether the passed AppSign matches the AppSign in the ZEGOCLOUD Console.
1001006	Input license is empty.
1001014	Description: No log file write permission. Possible reason: App does not have write permission for the log file save directory. Handling suggestion: Check whether the App has write file permission; check whether the App has write permission for the log file save directory.
1001015	Description: Log file path too long. Possible reason: The set log file path exceeds the limit. Handling suggestion: Check whether the log file path is too long.
1001020	Description: Failed to set room mode. Possible reason: Set room mode after initializing SDK. Handling suggestion: Set room mode before initializing SDK.
1001021	Description: Failed to set geofencing. Possible reason: Set geofencing after initializing SDK. Handling suggestion: Set geofencing before initializing SDK.
1001091	Description: Experimental API json parameter parsing failed. Possible reason: json content format is incorrect; method name or parameter is incorrect. Handling suggestion: Check whether json content format is correct; check whether method name or parameter is correct. For specific method names and parameters, please contact technical support.

When an error occurs calling loginRoom, or when the connection between the SDK and the ZEGO room service is abnormal, or when an exception occurs in the room, developers can obtain relevant error codes from onDebugError and onRoomStateChanged. Please handle them accordingly according to the following error code descriptions.

Error Code Enumeration	Description
1002001	Description: Number of logged in rooms exceeds the upper limit, currently only supports logging in to 1 main room at the same time. Possible reason: In single-room mode, logged in to multiple main rooms at the same time (including repeatedly calling to login to the same room A without logging out of room A). Handling suggestion: Check whether you have logged in to multiple main rooms at the same time in single-room mode.
1002002	Description: Have not logged in using this room ID. Possible reason: Before calling [logoutRoom] or [switchRoom] or [renewToken] or [setRoomExtraInfo], have not logged in using this room ID. Handling suggestion: Check whether you have logged in using this room ID.
1002005	Description: Input user ID is empty. Possible reason: Input user ID is empty. Handling suggestion: Check whether the input user ID is empty.
1002006	Description: Input user ID contains illegal characters. Possible reason: Input user ID contains illegal characters. Handling suggestion: User ID can only contain numbers, English characters, and '~', '!', '@', '#', '$', '%', '^', '&', '*', '(', ')', '_', '+', '=', '-', '`', ';', ',', '.', '<', '>', ''.
1002007	Input user ID is too long. The user ID length input by the [loginRoom] function is greater than or equal to 64 bytes. Please check the user ID input when calling the [loginRoom] function to ensure its length is less than 64 bytes.
1002008	Input user name is empty. The user name input by the [loginRoom] function is empty. Please check the user name input when calling the [loginRoom] function to ensure it is not empty.
1002009	Input user name contains illegal characters. The user name input by the [loginRoom] function contains illegal characters. Please check the user name input when calling the [loginRoom] function to ensure it only contains numbers, English characters, and '~', '!', '@', '#', '$', '%', '^', '&', '*', '(', ')', '_', '+', '=', '-', '`', ';', ',', '.', '<', '>', '/', ''.
1002010	Input user name is too long. The user name length input by the [loginRoom] function is greater than or equal to 256 bytes. Please check the user name input when calling the [loginRoom] function to ensure its length is less than 256 bytes.
1002011	Input room ID is empty. The room ID input by the [loginRoom] function is empty. Please check the room ID input when calling the [loginRoom] function to ensure it is not empty.
1002012	Input room ID contains illegal characters. The room ID input by the [loginRoom] function contains illegal characters. Please check the room ID input when calling the [loginRoom] function to ensure it only contains numbers, English characters, and '~', '!', '@', '#', '$', '%', '^', '&', '*', '(', ')', '_', '+', '=', '-', '`', ';', ',', '.', '<', '>', ''.
1002013	Input room ID is too long. The room ID length input by the [loginRoom] function is greater than or equal to 128 bytes. Please check the room ID input when calling the [loginRoom] function to ensure its length is less than 128 bytes.
1002014	Room extra information key is empty. The room extra information key input by the [setRoomExtraInfo] function is empty. Please check the room extra information key input when calling the [setRoomExtraInfo] function to ensure it is not empty.
1002015	Room extra information key is too long. The room extra information key length input by the [setRoomExtraInfo] function is greater than or equal to 128 bytes. Please check the room extra information key input when calling the [setRoomExtraInfo] function to ensure its length is less than 128 bytes.
1002016	Room extra information value is too long. The room extra information value length input by the [setRoomExtraInfo] function is greater than or equal to 128 bytes. Please check the room extra information value input when calling the [setRoomExtraInfo] function to ensure its length is less than 128 bytes.
1002017	Description: The number of keys set for room extra messages exceeds the supported maximum limit. Possible reason: Called setRoomExtraInfo multiple times with different keys. Handling suggestion: Currently only supports one key.
1002018	Description: In multi-room mode, the user ID or user name for logging in to rooms are not the same. Possible reason: In multi-room mode, different user IDs or user names were passed in when logging in to multiple rooms. Handling suggestion: In multi-room mode, pass in the same user ID or user name when logging in to multiple rooms.
1002019	Description: In multi-room mode, the [switchRoom] function is not available. Possible reason: In multi-room mode, the SDK does not support the [switchRoom] interface. Handling suggestion: You can first call [logoutRoom], then call [loginRoom].
1002030	Description: Failed to login to room, possibly due to network reasons. Possible reason: Current network is unavailable. Handling suggestion: It is recommended to switch networks and try again.
1002031	Description: Login to room timed out, possibly due to network reasons. Possible reason: Current network latency is relatively high. Handling suggestion: It is recommended to switch networks and try again.
1002033	Description: Login to room authentication failed. Possible reason: The token passed in when logging in is incorrect or has expired. Handling suggestion: Set a new token.
1002034	Description: The number of users logging in to the room exceeds the configured maximum user limit for the room (in the test environment, the default maximum number of users in a room is 50). Possible reason: Too many users in the current room. Handling suggestion: Contact ZEGOCLOUD Technical Support to increase the room user limit.
1002035	Description: In the test environment, the total number of concurrently logged in rooms exceeds the limit (the maximum number of concurrent rooms is 10). Possible reason: Too many rooms logged in at the same time. Handling suggestion: Log out of some rooms and log in again.
1002036	Description: Login failed, multi-room function is not activated, please contact ZEGOCLOUD Technical Support. Possible reason: Multi-room function is not activated. Handling suggestion: Contact ZEGOCLOUD Technical Support.
1002037	The total number of concurrently logged in rooms exceeds the limit, please contact ZEGOCLOUD Technical Support (this error code has been deprecated).
1002050	Description: User was kicked out of the room. Possible reason: Possibly the same user ID logged in on another device. Handling suggestion: Use a unique user ID.
1002051	Description: Room connection temporarily interrupted, retrying. Possible reason: Network reasons. Handling suggestion: Please wait or check whether the network is normal.
1002052	Description: Room connection disconnected. Possible reason: Network reasons. Handling suggestion: Please check whether the network is normal or switch the network environment.
1002053	Description: Retry login to room exceeded maximum retry time. Possible reason: Network reasons. Handling suggestion: Please check whether the network is normal or switch the network environment.
1002055	Description: Business backend sent a kick-out room command. Possible reason: Business backend sent a kick-out room command. Handling suggestion: Contact business backend to handle.
1002056	Description: Business backend sent a kick-out room command. Possible reason: Due to token expiration, the business backend sent a kick-out room command. Handling suggestion: Please update the token in time after receiving the notification callback that the token is about to expire.
1002057	Description: Business backend sent a kick-out room command. Possible reason: Due to internal session exception, the business backend sent a kick-out room command. Handling suggestion: Contact business backend to handle.
1002061	Description: Login to room sequence error. Possible reason: Did not login to the main room before logging in to multiple rooms. Handling suggestion: Call `loginRoom` to login to the main room before logging in to multiple rooms.
1002062	Description: Logout of room sequence error. Possible reason: Did not logout of multiple rooms before logging out of the main room. Handling suggestion: Logout of multiple rooms before logging out of the main room.
1002063	Description: No multi-room permission. Possible reason: No multi-room permission. Handling suggestion: Please contact technical support to enable.
1002064	Description: The room ID is already being used by the login room interface. Before logging out of the room, the current user cannot login to the room again. Possible reason: The room ID is already being used by the login room interface. Handling suggestion: Logout of the room with the same room ID.
1002065	Description: This method has been deprecated since version 2.9.0. Possible reason: This method has been deprecated since version 2.9.0. Handling suggestion: Please call the [setRoomMode] function to select multi-room mode before initializing the engine, then call [loginRoom] to login to multiple rooms.
1002066	Description: When the user logs in to the room, if they are on the server blacklist, this error code will be returned, indicating that login to the room is prohibited. Possible reason: The user is currently on the server blacklist. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1002067	Description: When the user creates the engine, if [AppSign] is not passed, and [Token] is not passed when logging in to the room, this error code will be returned. Possible reason: Did not pass [Token] when logging in to room. Handling suggestion: Set [Token] when logging in to the room.
1002071	Description: The calling frequency of this interface exceeds the upper limit. Possible reason: The application calls this interface too frequently. Handling suggestion: Control the calling frequency of this interface. For details, please refer to: /real-time-video-android-java/best-practice/restrictions.
1002072	Description: The frequency at which users in the room call this interface exceeds the upper limit. Possible reason: Users in the room call this interface too frequently. Handling suggestion: Control the frequency at which users in the room call this interface. For details, please refer to: /real-time-video-android-java/best-practice/restrictions.
1002073	Description: The calling frequency of room signaling interfaces exceeds the upper limit. Possible reason: The application calls room signaling interfaces too frequently. Handling suggestion: Control the application's calling frequency of room signaling interfaces (such as [sendCustomCommand] [sendBroadcastMessage]). For details, please refer to: /real-time-video-android-java/best-practice/restrictions.
1002074	Description: Token internal error. Possible reason: Internal unknown error. Handling suggestion: Contact ZEGOCLOUD Technical Support to handle.
1002075	Description: Token format error. Possible reason: The payload parameter passed when generating Token is in non-json format. Handling suggestion: Pass the payload as json format when generating Token correctly.
1002076	Description: Token Appid error. Possible reason: The Appid of the generated Token does not match the Appid used by the SDK, or the Appid type is incorrect. Handling suggestion: Use the Appid corresponding to the generated Token.
1002077	Description: Token userID error. Possible reason: The userID of the generated Token does not match the userID used for login, or the userID type is incorrect. Handling suggestion: Use the userID that generated the Token to login.
1002078	Description: Token expired. Possible reason: Token has expired, or the validity period parameter type passed when generating Token is incorrect. Handling suggestion: Regenerate Token.
1002079	Description: Token version error. Possible reason: The version when generating Token is incorrect. Handling suggestion: Use the correct version to generate Token.
1002080	Description: Token nonce parameter type error. Possible reason: The nonce parameter type passed when generating Token is incorrect. Handling suggestion: Ensure that nonce is int64 type data.
1002081	Description: Multi-room mode needs to be used. Possible reason: Used the wrong room mode, for example: single-room mode. Handling suggestion: Use the [setRoomMode] function to select multi-room mode before initializing the engine.
1002082	Description: Updated Token for the room does not have publishing stream permission. Possible reason: Token does not have publishing stream permission. Handling suggestion: Pass in a Token with publishing stream permission.
1002083	Description: The custom data attached when logging in exceeds the length limit. Possible reason: The login custom callback data is too long. Handling suggestion: Control the login custom data length to not exceed 128 bytes.
1002084	Description: Used license authentication when logging in, license not found. Possible reason: License filled in incorrectly. Handling suggestion: Verify the correctness of the license.
1002085	Description: Used license authentication when logging in, license has expired. Handling suggestion: Contact ZEGOCLOUD Technical Support to handle.
1002086	Description: User has already logged in elsewhere. Handling suggestion: Confirm whether the login user has already logged in elsewhere.
1002087	Description: Used license authentication, when using related functions, the license has function restrictions, use of this function is not allowed. Handling suggestion: Verify the function restrictions of the license and use functions reasonably.
1002099	Description: System internal exception caused room login failure. Possible reason: Internal unknown error. Handling suggestion: Contact ZEGOCLOUD Technical Support to handle.

After calling the publishing stream interface, or if an exception occurs during publishing stream, developers can obtain relevant error codes from onPublisherStateUpdate. Please handle them accordingly according to the following error codes.

After calling interfaces such as relaying to CDN or updating stream extra information, developers can obtain relevant error codes from the callback parameter of the API (Java is anonymous class, OC is block, C++ is lambda).

Handling the situation where the publishing stream callback error code is not 0:

When state is PUBLISHER_STATE_NO_PUBLISH and errcode is not 0, it indicates that publishing stream has failed and will not retry publishing stream anymore. At this time, you can display a publishing stream failure prompt on the interface;

When state is PUBLISHER_STATE_PUBLISH_REQUESTING and errcode is not 0, it indicates retrying to publish stream. At this time, if publishing stream is not successful after exceeding the retry time, a publishing stream failure notification will be thrown.

Error Code Enumeration	Description
1003001	Description: Publishing stream failed due to no data. Possible reason: No data in publishing stream. Handling suggestion: Check whether the video and audio capture modules are working normally.
1003002	Description: Publishing stream failed due to incorrect bitrate setting. Possible reason: The set video bitrate, audio bitrate, or traffic control minimum video bitrate threshold exceeds the upper limit. Handling suggestion: Please check whether the unit (kbps) is incorrect. Adjust the bitrate setting.
1003005	Description: Traffic control property parameter setting error. Possible reason: The set traffic control property is less than 0 or exceeds all combinations. Handling suggestion: Check the setting of the traffic control property parameter.
1003010	Description: Publishing stream failed, H.265 encoding not supported. Possible reason: Hardware device does not support H.265 encoding, or SDK does not include H.265 encoding module. Handling suggestion: Contact ZEGOCLOUD Technical Support to confirm whether the SDK includes the H.265 encoding module. If the hardware device does not support it, it is recommended to upgrade the hardware.
1003011	Description: Segmentation device performance insufficient. Possible reason: Device performance insufficient. Handling suggestion: Change device.
1003012	Description: The device does not support segmentation. Possible reason: Device does not support, or enabled segmentation for multiple channels. Handling suggestion: Change device or only enable segmentation for one channel.
1003013	Description: Segmentation not authorized. Possible reason: The appid has not configured the segmentation function. Handling suggestion: Please contact ZEGOCLOUD Technical Support to configure the segmentation function.
1003014	Description: Segmentation parameter error. Possible reason: Segmentation is set as green screen type, background blur is not allowed to be set. Handling suggestion: Please use the correct parameters to enable segmentation.
1003015	Description: Segmentation background loading error. Possible reason: Background video or image path is incorrect, or content is incorrect. Handling suggestion: Please set the correct background image or video.
1003020	Description: Publishing stream temporarily interrupted, retrying. Possible reason: Network fluctuation or poor network signal. Handling suggestion: Please wait or check whether the network is normal.
1003021	Description: Retry publishing stream exceeded maximum retry time. Possible reason: Poor network signal, exceeded maximum retry time. Handling suggestion: Check network status or switch to other networks.
1003023	Description: Publishing stream failed, the channel is already publishing stream. Possible reason: The channel is already publishing stream. Handling suggestion: Please check the business logic to avoid repeatedly publishing stream on a channel that is already publishing stream. Switch to another channel to publish stream.
1003025	Description: Publishing stream failed, the stream is configured by the backend system to prohibit publishing. Possible reason: The stream is configured by the backend system to prohibit publishing. Handling suggestion: Contact ZEGOCLOUD Technical Support to handle.
1003028	Description: Publishing stream failed, the same stream already exists in the room. Possible reason: The same stream already exists in the room. Handling suggestion: Use a new stream ID. Adjust the stream name generation strategy to ensure uniqueness.
1003029	Description: Publishing stream failed, connection to RTMP server interrupted. Possible reason: Publishing address abnormal, poor network signal. Handling suggestion: Please check the network or whether the publishing address is abnormal.
1003030	Description: Publishing stream video screenshot failed. Possible reason: Stopped preview and publishing stream abnormal. Handling suggestion: Start preview or republish stream.
1003040	Description: Failed to update relaying to CDN status. Possible reason: The relayed URL is incorrect. Handling suggestion: Check whether the input URL is valid.
1003043	Description: Failed to send SEI. Possible reason: data is empty. Handling suggestion: Pass in non-empty data.
1003044	Description: Failed to send SEI. Possible reason: Input data exceeds length limit. Handling suggestion: The sent SEI data length should be less than 4096 bytes.
1003045	Description: Failed to send audio secondary information. Possible reason: data is empty. Handling suggestion: Pass in non-empty data.
1003046	Description: Failed to send audio secondary information. Possible reason: Input data exceeds length limit. Handling suggestion: The sent audio secondary information data length should be less than 1024 bytes.
1003050	Stream extra information is empty (this error code has been deprecated)
1003051	Stream extra information is too long, maximum length should be less than 1024 bytes (this error code has been deprecated)
1003053	Failed to update stream extra information, please check network connection (this error code has been deprecated)
1003055	Description: Failed to set publishing stream watermark. Possible reason: The passed watermark path is empty. Handling suggestion: Pass in a non-empty watermark path.
1003056	Description: Failed to set publishing stream watermark. Possible reason: The passed watermark path exceeds the byte size limit. Handling suggestion: The passed watermark path should be less than 512 bytes.
1003057	Description: Failed to set publishing stream watermark. Possible reason: The publishing stream watermark path input is incorrect or the image format is not supported. Handling suggestion: Input the correct watermark path, only supports jpg and png image formats.
1003058	Description: Watermark layout error. Possible reason: Watermark layout area exceeds the encoding resolution size. Handling suggestion: When setting a watermark, ensure that the watermark layout area does not exceed the size of the encoding resolution.
1003060	Description: Publishing stream encryption key is invalid. Possible reason: The set encryption key length is not supported. Handling suggestion: Publishing stream encryption key length needs to be 16/24/32 bytes.
1003070	Description: Publishing stream function call failed. Possible reason: In multi-room mode, the called publishing stream function is incorrect. Handling suggestion: Call the publishing stream function with the parameter [ZegoPublisherConfig].
1003071	Description: Publishing stream function call error. Possible reason: In multi-room mode, the [roomID] of the publishing stream function cannot be empty. Handling suggestion: In multi-room mode, the [roomID] parameter of the publishing stream function cannot be empty.
1003072	Description: Publishing/Playing stream authentication error. Possible reason: The [appSign] passed when creating the engine is incorrect, or the [Token] passed when logging in to the room is incorrect or has expired. Handling suggestion: Pass in the correct [Token] when logging in, or call [renewToken] to update the Token in time when receiving the [onRoomTokenWillExpire] callback.
1003073	Description: The path error for the static image published when the camera is turned off is specified. Possible reason: Path spelling error or no read permission. Handling suggestion: Check whether the set image path is correct and whether there is read permission.
1003080	Description: Unsupported video encoder. Possible reason: The current SDK does not have the selected encoder. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1003081	Description: Encoding failed. Possible reason: The selected encoder encoding failed. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1003099	Description: System internal exception caused publishing stream failure. Possible reason: System internal exception caused publishing stream failure. Handling suggestion: Please contact technical support to resolve.

After calling the playing stream interface, or if an exception occurs during playing stream, developers can obtain relevant error codes from the onPlayerStateUpdate playing stream status callback. Please handle them accordingly according to the following error codes.

Handling the situation where the playing stream callback error code is not 0:

When state is PLAYER_STATE_NO_PLAY and errcode is not 0, it indicates that playing stream has failed and will not retry playing stream anymore. At this time, you can display a playing stream failure prompt on the interface;

When state is PLAYER_STATE_PLAY_REQUESTING and errcode is not 0, it indicates retrying to play stream. At this time, if playing stream is not successful after exceeding the retry time, a playing stream failure notification will be thrown.

Error Code Enumeration	Description
1004001	Description: Playing stream failed. Possible reason: Possibly no data in playing stream. Handling suggestion: Please check whether the publishing stream end publishes stream normally or try to play the stream again. If the problem is still not resolved, please contact technical support to resolve.
1004002	Description: Playing stream failed. Possible reason: Stream does not exist. Handling suggestion: Please check whether the remote end has successfully published stream, or whether the environments of publishing and playing stream are inconsistent.
1004003	Description: Playing stream authentication error. Possible reason: Cross-APP playing stream passed [Token] is incorrect or expired. Handling suggestion: Pass in the correct [Token] for playing stream, or update the [Token] in time.
1004004	Description: The device does not support super resolution. Possible reason: The server configuration specifies that the device does not support super resolution, or the server configuration failed to play. Handling suggestion: Change device and retry or contact ZEGOCLOUD Technical Support.
1004005	Description: The number of super resolution streams exceeds the limit. Possible reason: The number of super resolution streams exceeds the limit. Handling suggestion: Currently supports at most 1 playing stream super resolution.
1004006	Description: Super resolution original resolution exceeds the limit. Possible reason: Super resolution original resolution exceeds 640x480. Handling suggestion: Lower the resolution.
1004007	Description: Super resolution device performance insufficient. Possible reason: Device performance insufficient. Handling suggestion: Change device.
1004008	Description: Super resolution not initialized. Possible reason: Super resolution not initialized. Handling suggestion: Please initialize super resolution.
1004010	Description: Playing stream error. Possible reason: Playing stream exceeded the maximum quantity. Handling suggestion: Currently supports at most 12 playing streams (contact technical support for expansion if needed).
1004011	Description: The stream is not being played. Possible reason: The stream is not being played. Handling suggestion: Please confirm the stream has been played through the [onPlayerStateUpdate] or [onUserStreamStateUpdate] callback.
1004020	Description: Playing stream temporarily interrupted. Possible reason: Network exception. Handling suggestion: Please wait or check the network environment.
1004025	Description: Playing stream failed. Possible reason: The stream is configured by the backend system to prohibit publishing. Handling suggestion: Please contact technical support to resolve.
1004030	Description: Failed to take a screenshot of the playing stream video, please check whether the stream to be screenshot is normal. Possible reason: No stream was played. Handling suggestion: Check whether playing stream has started and whether any exceptions occurred during the playing stream process.
1004060	Description: Playing stream decryption key is invalid, currently the key length only supports 16/24/32 bytes. Possible reason: Input key length is not 16/24/32 bytes. Handling suggestion: Adjust the input key length to 16/24/32 bytes.
1004061	Description: Playing stream decryption failed, please check whether the decryption key is correct. Possible reason: The input decryption key is incorrect. Handling suggestion: Please check whether the decryption key matches the publishing stream encryption key.
1004070	Description: Called the wrong function after enabling multi-room function resulting in playing stream failure. Possible reason: Called a playing stream interface that only takes effect in single-room mode. Handling suggestion: Please use the same function with ZegoPlayerConfig and specify the room ID to play stream.
1004071	Description: In multi-room mode, the roomID parameter for playing stream cannot be empty. Possible reason: The roomID parameter for playing stream is empty. Handling suggestion: Please enter the correct roomID.
1004072	Description: When using the SDK to play low-latency live streaming streams, if you have not activated the low-latency live streaming service, this error code will be returned. Possible reason: Low-latency live streaming service not activated. Handling suggestion: Please contact ZEGOCLOUD Technical Support to activate the low-latency live streaming service.
1004080	Description: Unsupported video decoder. Possible reason: The current SDK does not have the selected decoder. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1004081	Description: Decoding failed. Possible reason: Decoding failed. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1004099	Description: System internal exception caused playing stream failure. Possible reason: SDK internal error. Handling suggestion: Please contact ZEGOCLOUD Technical Support.

1005xxx Stream Mixing Error

When an exception occurs during the process of starting/stopping stream mixing, developers can obtain relevant error codes through the callback parameter of the API (Java is anonymous class, OC is block, C++ is lambda). As follows:

Error Code Enumeration	Description
1005000	Description: Stream mixing service is not supported. Possible reason: Stream mixing service not configured. Handling suggestion: Please activate it in the console or contact ZEGOCLOUD business personnel.
1005001	Description: Stream mixing task ID is empty. Possible reason: The input stream mixing task ID is empty when starting the stream mixing task. Handling suggestion: Please enter the correct stream mixing task ID.
1005002	Description: Stream mixing task ID is too long. Possible reason: Stream mixing task ID is greater than 256 bytes. Handling suggestion: Please enter a stream mixing task ID less than 256 bytes.
1005003	Description: Stream mixing task ID is invalid. Possible reason: The stream mixing task ID contains illegal characters. Handling suggestion: Stream mixing task ID only supports numbers, English characters, and '~', '!', '@', '$', '%', '^', '&', '*', '(', ')', '_', '+', '=', '-', '`', ';', ',', '.', '<', '>', '/', ''. Please enter a stream mixing task ID in the correct format.
1005005	Description: Stream mixing task configuration has illegal parameters. Possible reason: 1. Stream mixing task ID is empty; 2. Stream mixing room ID is empty; 3. Stream mixing custom data length exceeds 1000 bytes; 4. Stream mixing output target stream is empty. Handling suggestion: Please check the stream mixing task configuration parameters.
1005006	Description: Stream mixing output target parameter format is illegal. Possible reason: When the target of the stream mixing output is streamID, illegal characters are passed in. Handling suggestion: Please check whether the target of the stream mixing output is of streamID type. If so, target only supports numbers, English characters, and "-", "_".
1005010	Description: Failed to request to start stream mixing task. Possible reason: Requests too frequent, exceeding the service QPS limit; network exception; passed illegal stream mixing output URL. Handling suggestion: Please ensure the QPS of stream mixing requests is less than 10; check the network; and pass in a legal stream mixing output URL.
1005011	Description: Failed to request to stop stream mixing task. Possible reason: Possibly network error reasons. Handling suggestion: Please check the network environment.
1005012	The stream mixing task must be stopped by the user who started the task. This error code has been deprecated.
1005015	Description: Starting stream mixing tasks too frequently. Possible reason: Requests too frequent, exceeding the service QPS limit. Handling suggestion: Please ensure the QPS of stream mixing requests is less than 100.
1005016	Description: Stopping stream mixing tasks too frequently. Possible reason: Requests too frequent, exceeding the service QPS limit. Handling suggestion: Please ensure the QPS of stopping stream mixing requests is less than 100.
1005020	Description: Stream mixing task input stream list is empty. Possible reason: Stream mixing task input stream list is empty. Handling suggestion: Please check the stream mixing task input stream list.
1005021	Description: Stream mixing task output list is empty. Possible reason: Stream mixing task output list is empty. Handling suggestion: Please check the stream mixing task output list.
1005023	Description: Stream mixing task video configuration invalid. Possible reason: Stream mixing task video configuration invalid. Handling suggestion: Please check the validity of the stream mixing task video configuration parameters.
1005024	Description: Stream mixing task audio configuration invalid. Possible reason: 1. Used unsupported audio codec format. 2. Audio bitrate exceeds 192 kbps. Handling suggestion: Please check the stream mixing task audio configuration.
1005025	Description: Exceeded the maximum number of input streams. Possible reason: Maximum supports 9 input streams, possibly passed in more than 9 input streams. Handling suggestion: Please check the stream mixing task input stream configuration.
1005026	Description: Failed to start stream mixing. Possible reason: Input stream does not exist. Handling suggestion: Please ensure the stream corresponding to the input streamID is publishing stream.
1005027	Description: Failed to start stream mixing. Possible reason: Stream mixing input parameter error, possibly the input stream layout exceeds the canvas range. Handling suggestion: Please input the correct stream mixing parameters [ZegoMixerTask].
1005028	Description: Stream mixing input text watermark is too long. Possible reason: The text watermark length in the stream mixing input parameter exceeds the limit. Handling suggestion: Please ensure the input text watermark length does not exceed 512 bytes.
1005029	Description: Stream mixing output target is too long. Possible reason: The stream mixing output target parameter length exceeds the limit. Handling suggestion: Please ensure the output target length is less than 1024 bytes.
1005030	Description: Failed to start stream mixing. Possible reason: Exceeded the maximum number of output streams. Handling suggestion: Maximum supports 3 output streams.
1005031	Description: Failed to start stream mixing. Possible reason: Exceeded the maximum number of focus voice input streams. Handling suggestion: Maximum supports 4 input streams setting focus voice.
1005032	Description: Stream mixing advanced configuration is too long. Possible reason: The stream mixing advanced configuration parameter length exceeds the limit. Handling suggestion: Please ensure the advanced configuration length does not exceed 512 bytes.
1005033	Description: Stream mixing watermark path is too long. Possible reason: The stream mixing watermark path parameter length exceeds the limit. Handling suggestion: Please ensure the watermark path length does not exceed 512 bytes.
1005034	Description: Stream mixing input image link is too long. Possible reason: The image link length in the stream mixing input parameter exceeds the limit. Handling suggestion: Please ensure the input image link length does not exceed 1024 bytes.
1005035	Description: Failed to input image for stream mixing. Possible reason: The image format in the stream mixing input parameter is incorrect. Handling suggestion: Use JPG and PNG formats. Supports 2 usage methods: 1. URI: Provide the image to ZEGOCLOUD Technical Support for configuration. After configuration is completed, the image URI will be provided, for example: preset-id://xxx.jpg. 2. URL: Only supports HTTP protocol.
1005036	Description: Failed to input image for stream mixing. Possible reason: The image size in the stream mixing input parameter exceeds the limit. Handling suggestion: Limit the image size to within 1M.
1005037	Description: Stream mixing output stream room configuration error. Possible reason: The room does not exist when starting stream mixing. Handling suggestion: Please ensure that the room corresponding to the configured targetRoom exists.
1005050	Description: Failed to start stream mixing. Possible reason: Stream mixing authentication failed. Handling suggestion: Contact ZEGOCLOUD Technical Support.
1005061	Description: Failed to start stream mixing. Possible reason: Input image watermark is empty. Handling suggestion: Please input the correct watermark parameters [ZegoWatermark].
1005062	Description: Failed to start stream mixing. Possible reason: Input image watermark parameter error, possibly the layout exceeds the canvas range. Handling suggestion: Please input the correct watermark parameters [ZegoWatermark].
1005063	Description: Failed to start stream mixing. Possible reason: Input watermark URL is illegal. Handling suggestion: Watermark URL must start with "preset-id://" and needs to end with ".jpg" or ".png".
1005066	Description: Stream mixing background image path is too long. Possible reason: The stream mixing background image path parameter length exceeds the limit. Handling suggestion: Please ensure the background image path length does not exceed 1024 bytes.
1005067	Description: Failed to start stream mixing. Possible reason: Input background image URL is illegal. Handling suggestion: Background image URL must start with "preset-id://" and needs to end with ".jpg" or ".png".
1005068	Description: Failed to start stream mixing. Possible reason: User custom data is too long. Handling suggestion: The input custom maximum length does not exceed 1000 bytes.
1005070	Description: Failed to start stream mixing. Possible reason: Automatic stream mixing server not found. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1005099	Description: Stream mixing internal error. Possible reason: Unknown error occurred in stream mixing. Handling suggestion: Please contact ZEGOCLOUD Technical Support.

1006xxx Device Error

The process of publishing/playing streams may cause errors in the audio/video devices used. Versions before 2.15.0: Listen to the onDeviceError callback; versions 2.15.0 and later: Listen to the onLocalDeviceExceptionOccurred callback. Related error codes are as follows:

Error Code Enumeration	Description
1006001	Description: Device general error. Possible reason: Device cannot work normally. Handling suggestion: Use the system's recording video or audio application to check whether the device can work normally. If the device is normal, please contact ZEGOCLOUD Technical Support.
1006002	Description: Device ID does not exist. Possible reason: Device ID spelling error, or corresponding device was plugged/unplugged. Handling suggestion: Please use the SDK's interface to obtain the device ID and check whether the device is correctly connected.
1006003	Description: No device permission. Possible reason: Did not apply for or obtain permission to use the corresponding device. Handling suggestion: Please check whether the application has correctly applied for camera or microphone permissions, and whether the user has granted the corresponding permissions.
1006004	Description: Device capture frame rate is 0. Possible reason: Device error, or device has no permission. Handling suggestion: Please use the system's recording video or audio application to check whether the device can work normally. Please check whether the application has correctly applied for camera or microphone permissions, and whether the user has granted the corresponding permissions. If the device is normal and the application has obtained the corresponding device permissions, please contact ZEGOCLOUD Technical Support.
1006005	Description: Device is occupied. Possible reason: Device is occupied by other programs. Handling suggestion: Please use the system's recording video or audio application to check whether the device can work normally. Ensure that the device is not occupied by other applications.
1006006	Description: Device was unplugged. Possible reason: Device was unplugged or not properly connected. Handling suggestion: Check the device wiring and reconnect the device properly.
1006007	Description: Device needs to be restarted. Possible reason: Driver update, or device error needs restart. Handling suggestion: Restart the device.
1006008	Description: Device media lost. Possible reason: Media service cannot recover. Handling suggestion: Restart the device.
1006020	Description: List is empty when releasing device list. Possible reason: Device list has been released or has not been initialized yet. Handling suggestion: Ignore.
1006031	Description: The set sound wave monitoring interval is out of range. Possible reason: The set sound wave monitoring interval is less than 100 milliseconds or greater than 3000 milliseconds. Handling suggestion: Reset a valid sound wave monitoring interval. Valid sound wave monitoring interval is [100, 3000], unit milliseconds.
1006032	Description: The set audio spectrum monitoring interval is out of range. Possible reason: The set audio spectrum monitoring interval is less than 10 milliseconds. Handling suggestion: Reset a valid audio spectrum monitoring interval. Valid audio spectrum monitoring interval must be greater than 10 milliseconds.
1006040	Description: Failed to set camera zoom. Possible reason: The set camera zoom factor exceeds the range. Handling suggestion: The set camera zoom factor cannot exceed the obtained maximum range. The maximum range can be obtained through [getCameraMaxZoomFactor].
1006041	Description: Failed to set camera exposure compensation. Possible reason: The set camera exposure compensation value exceeds the range. Handling suggestion: Set the camera exposure compensation range between [-1,1].
1006042	Invalid voice activity detector type
1006099	Description: Device internal error. Handling suggestion: Contact ZEGOCLOUD Technical Support.

Errors thrown when an error occurs calling SDK internal preprocessing related interfaces (for example, setting SDK built-in AI effects).

Error Code Enumeration	Description
1007001	Description: Preprocessing module unknown error. Handling suggestion: Please contact ZEGOCLOUD Technical personnel.
1007005	Description: Failed to set beautification configuration. Possible reason: The passed beautification parameters are incorrect. Handling suggestion: Please check the passed [ZegoBeautifyOption] type parameter.
1007006	Reverb parameter is null, please check the passed reverb parameters. This error code has been deprecated.
1007007	Voice changer parameter is null, please check the passed voice changer parameters. This error code has been deprecated.
1007011	Description: Failed to set reverb parameters. Possible reason: Reverb room size parameter invalid. Handling suggestion: Reverb room size parameter normal range 0.0 ~ 1.0.
1007012	Description: Failed to set reverb parameters. Possible reason: Reverb reverberance parameter invalid. Handling suggestion: Reverb reverberance parameter normal range 0.0 ~ 0.5.
1007013	Description: Failed to set reverb parameters. Possible reason: Reverb damping parameter invalid. Handling suggestion: Reverb damping parameter normal range 0.0 ~ 2.0.
1007014	Description: Failed to set reverb parameters. Possible reason: Reverb dry_wet_ratio parameter invalid. Handling suggestion: Reverb dry_wet_ratio parameter normal range greater than 0.0.
1007015	Description: Failed to start virtual stereo. Possible reason: Virtual stereo angle parameter invalid. Handling suggestion: angle parameter normal range -1 ~ 360.
1007016	Description: Failed to set voice changer parameters. Possible reason: Voice changer parameter param setting invalid. Handling suggestion: Parameter param normal range -12.0 ~ 12.0.
1007017	Reverb echo parameter is null, please check the passed reverb echo parameters
1007018	Description: Failed to set reverb echo parameters. Possible reason: Reverb echo parameters invalid. Handling suggestion: Input the correct reverb echo parameters [ZegoReverbEchoParam].
1007019	Description: Failed to enable or disable electronic music effects. Possible reason: Electronic music starting pitch parameter tonal is invalid. Handling suggestion: Electronic music starting pitch parameter normal range 0 ~ 11.
1007020	Description: Failed to enable or disable AI Effects environment. Possible reason: Did not enable or disable AI Effects environment before starting the engine. Handling suggestion: Please ensure to enable or disable AI Effects environment before starting the engine, for example: before calling (startPreview), (startPublishingStream), (startPlayingStream), (createMediaPlayer) or (createAudioEffectPlayer).
1007021	Description: Failed to enable or disable AI Effects. Possible reason: AI Effects environment not started. Handling suggestion: Please call [startEffectsEnv] to start the AI Effects environment first.
1007022	Description: Failed to set AI Effects parameters. Possible reason: AI Effects environment not started. Handling suggestion: Please call [startEffectsEnv] to start the AI Effects environment first.
1007023	Description: Effects AI Effects does not support the currently set video data type. Possible reason: For the [enableCustomVideoProcessing] interface, Windows platform only supports raw_data, Apple devices only support cv_pixel_buffer, Android platform supports gl_texture_2d. Handling suggestion: Select the correct video data type.
1007024	Description: Failed to enable voice enhancement. Possible reason: Voice enhancement level parameter invalid. Handling suggestion: Voice enhancement level value range [0, 10], please use the correct parameter value.

1008xxx Media Player Errors

Error codes related to the process of using the SDK's built-in media player related APIs are as follows:

Error Code Enumeration	Description
1008001	Description: The media player instance has not been created. Possible reason: The media player instance has not been created. Handling suggestion: Please create the media player instance [createMediaPlayer] first before using the media player.
1008003	Description: Media player playback failed. Possible reason: Resource file not loaded. Handling suggestion: Please load media resources [loadResource] before the media player starts playing [start].
1008004	Description: The specified resource file path is too long. Possible reason: The specified resource file path is too long, maximum length should be less than 1024 bytes. Handling suggestion: Pass in a resource file path less than 1024 bytes.
1008005	Description: Media player failed to load file. Possible reason: File format not supported. Handling suggestion: Files of this format are not supported, please use files of supported formats.
1008006	Description: Media player failed to load file. Possible reason: Path does not exist. Handling suggestion: Please check the validity of the media file path.
1008007	Description: Media player failed to load file. Possible reason: Decoding error. Handling suggestion: Please check whether the media file is damaged or contact ZEGOCLOUD Technical Support.
1008008	Description: Media player failed to load file. Possible reason: No playable audio/video stream. Handling suggestion: Please check whether the media file data is empty.
1008009	Description: Copyrighted music resource file has expired. Possible reason: Resource file has exceeded its validity period. Handling suggestion: Please reorder the song or accompaniment.
1008010	Description: Media player playback failed. Possible reason: Error occurred during file parsing process. Handling suggestion: Please retry or contact ZEGOCLOUD Technical Support.
1008011	Description: Copyrighted music resource has expired. Possible reason: Copyrighted music resource has expired. Handling suggestion: Please reorder this copyrighted music resource.
1008012	Description: Copyrighted music resource ID is too long. Possible reason: Copyrighted music resource ID is too long, maximum length should be less than 512 bytes. Handling suggestion: Pass in a copyrighted music resource ID less than 512 bytes.
1008013	Description: User cancelled. Possible reason: Called [Stop] to stop the player after calling [Load] to load resources. Handling suggestion: Expected behavior when calling [Stop] during resource loading.
1008014	Description: The media player has already started. Possible reason: [Load] has already been called. Handling suggestion: Please call [Stop] first, then call [Load].
1008016	Description: Media player Seek failed. Possible reason: File has not been loaded yet. Handling suggestion: Please load the media file [loadResource] first before performing Seek [seekTo].
1008020	Description: The media player has set a video data format not supported by the platform. Possible reason: The media player has set a video data format not supported by the current platform (for example, CVPixelBuffer does not support NV21 on the iOS platform). Handling suggestion: Check whether the data format format set by the interface [setVideoHandler] is a data format supported by the current platform and set the correct data format.
1008030	Description: Media player created instances exceed the maximum limit. Possible reason: The number of media player created instances exceeds the maximum limit, at most 4 instances can be created. Handling suggestion: The media player can create at most 4 instances. Please ensure that the number of created media player instances does not exceed the maximum limit.
1008040	Description: Media player failed to specify audio track. Possible reason: The specified audio track does not exist. Handling suggestion: Check the audio track of the playing file. You can call [getAudioTrackCount] to obtain it.
1008041	Description: Media player voice changer parameter setting is invalid. Possible reason: Setting parameter error. Handling suggestion: Check the setting parameter control is between -12.0 and 12.0.
1008042	Description: takeSnapshot screenshot failed. Possible reason: Video is not playing or `setPlayerCanvas` was not called to display the video on the control. Handling suggestion: Check whether the video is playing normally (you can view the [onPlayStart] callback), and whether the screen is displayed normally.
1008043	Description: The passed parameter is not within the legal value range. Possible reason: Passed parameter error. Handling suggestion: Please view the interface notes and pass in values within the legal value range.
1008044	Description: Failed to cache network resource files. Possible reason: [seekTo] operation during playback will cause caching failure, network reasons or active stop will also cause caching failure due to incomplete playback. Handling suggestion: Check whether there is a [seekTo] operation, whether network reasons caused playback failure, or whether playback was actively stopped.
1008099	Description: Media player internal error. Possible reason: Internal error. Handling suggestion: Contact technical support.

1009xxx IM Error

When sending IM messages, developers can obtain relevant error codes from the callback parameter of the API (Java is anonymous class, OC is block, C++ is lambda), as follows:

Error Code Enumeration	Description
1009001	Description: Input message content is empty. Possible reason: Message content is empty. Handling suggestion: Enter non-empty message.
1009002	Description: Input message content is too long. Possible reason: Message content is greater than 1024 bytes. Handling suggestion: Control message content to less than 1024 bytes.
1009003	Description: Input real-time sequential data is too long. Possible reason: The input data length is greater than 4096 bytes. Handling suggestion: Check the input data length, consider splitting large data packets into multiple small data packets and sending them multiple times.
1009005	Description: The target room for sending the message is inconsistent with the currently logged in room. Possible reason: The target room for sending the message is inconsistent with the currently logged in room. Handling suggestion: Pass in the currently logged in room ID when sending the message.
1009010	Description: Failed to send message. Possible reason: Network reasons. Handling suggestion: Check the network.
1009011	Description: Failed to send custom signaling. Possible reason: Input user ID is empty. Handling suggestion: Please enter the correct user ID.
1009012	Description: Failed to send custom signaling. Possible reason: Input user ID is too long. Handling suggestion: Please enter the correct user ID, user ID maximum is 64 bytes.
1009013	Description: Failed to send message. Possible reason: Message input length exceeds the limit. Handling suggestion: Check the input content length or contact ZEGOCLOUD Technical Support to expand message content length.
1009015	Description: Failed to send room broadcast message. Possible reason: QPS exceeded the limit. Handling suggestion: Control the maximum QPS to 2.
1009031	Description: Failed to create real-time sequential data manager instance. Possible reason: A manager instance has already been created for this room ID. Handling suggestion: At most 1 instance can be created for each room ID. If you need to create multiple instances, please use other room IDs.
1009032	Description: Specified real-time sequential data manager instance not found. Possible reason: This manager instance has not been created yet. Handling suggestion: Please call the [createRealTimeSequentialDataManager] function to create the manager instance first.
1009033	Description: No available publishing stream channel found for broadcasting. Possible reason: The developer has already used all publishing stream channels. Handling suggestion: Do not occupy all publishing stream channels. Check whether there is a stream that can stop publishing stream, or contact technical support to increase available publishing stream channels.
1009034	Description: The stream ID to start broadcasting or subscribing is not available. Possible reason: This stream ID is already used for audio/video stream services (such as [startPublishingStream] / [startPlayingStream]) on this device. Handling suggestion: Please use another stream ID for broadcasting.
1009035	Description: Duplicate start broadcasting. Possible reason: Developer repeatedly called the [startBroadcasting] function. Handling suggestion: The stream to be broadcast is already broadcasting. Please check the business logic to avoid repeatedly broadcasting the stream that is already broadcasting.
1009036	Description: The stream to stop broadcasting does not exist. Possible reason: The stream ID passed by the developer when calling the [stopBroadcasting] function is not broadcasting. Handling suggestion: Check whether the stream ID is correct, or whether this stream ID is not broadcasting.
1009037	Description: The stream to stop subscribing does not exist. Possible reason: The stream ID passed by the developer when calling the [stopSubscribing] function is not subscribing. Handling suggestion: Check whether the stream ID is correct, or whether this stream ID is not subscribing.
1009038	Description: Duplicate start subscription. Possible reason: Developer repeatedly called the [startSubscribing] function. Handling suggestion: The stream to subscribe is already subscribing. Please check the business logic to avoid duplicate subscription.
1009039	Description: Real-time sequential data sending failed. Possible reason: Broadcasting has not yet started, or broadcasting encountered network issues. Handling suggestion: Check whether [startBroadcasting] has been called to start broadcasting, or check whether the network is smooth.

When using SDK media recording related API functions, developers can obtain relevant error codes from the callback parameter of the API (Java is anonymous class, OC is block, C++ is lambda), as follows:

Error Code Enumeration	Description
1010002	Description: File name suffix not supported. Possible reason: File name suffix not supported. Handling suggestion: Currently only supports .mp4/.aac/.flv file name suffixes.
1010003	Description: Recording interface general error. Possible reason: The passed parameters are not legal. Handling suggestion: Check whether the recording file save path or recording file format passed in the call is legal.
1010011	Description: The specified recording file path is too long. Possible reason: The specified recording file path is too long, maximum length should be less than 1024 bytes. Handling suggestion: Pass in a recording file path less than 1024 bytes.
1010012	Description: SDK internal error. Possible reason: Internal error. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1010013	Description: Failed to open file. Possible reason: Invalid file path; no file read/write permission. Handling suggestion: Pass in a valid and normally readable/writable file path.
1010014	Description: Failed to write file. Possible reason: No file write permission. Handling suggestion: Pass in a file path that can normally be read and written.
1010017	Description: Insufficient disk space. Possible reason: Insufficient disk space. Handling suggestion: Ensure sufficient disk space.
1010018	Description: File handle exception. Possible reason: File handle exception. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1010019	Description: Input output exception. Possible reason: Input output exception. Handling suggestion: Please contact ZEGOCLOUD Technical Support.

When using SDK custom capture, custom rendering related API functions, developers can obtain relevant error codes from the callback parameter of the API (Java is anonymous class, OC is block, C++ is lambda), as follows:

Error Code Enumeration	Description
1011001	Description: Custom video capture device not created. Possible reason: Created custom video capture device before receiving onStart callback. Handling suggestion: Ensure to create the custom video capture device after receiving the onStart callback.
1011002	Description: Custom video capture module not enabled. Possible reason: Custom video capture not enabled in the initialization configuration. Handling suggestion: Please contact ZEGOCLOUD Technical Support to ensure that custom video capture has been enabled in the initialization configuration.
1011003	Description: Failed to set custom capture/pre-processing/rendering. Possible reason: Did not set custom capture/pre-processing/rendering before starting the engine. Handling suggestion: Please ensure to set custom capture/pre-processing/rendering before starting the engine, for example: before calling (startPreview), (startPublishingStream), (startPlayingStream), (createMediaPlayer) or (createAudioEffectPlayer).
1011004	Description: Custom video pre-processing module not created. Possible reason: Internal video related module not created. Handling suggestion: Please call [startPreview] or [startPublishingStream] first.
1011005	Description: Custom video pre-processing module not enabled. Possible reason: Custom video pre-processing module not enabled. Handling suggestion: Call [enableCustomVideoProcessing] to enable the custom video pre-processing module.
1011010	Description: The currently set custom video capture format does not support this API. Possible reason: The currently set custom video capture format does not support this API. Handling suggestion: Please contact ZEGOCLOUD Technical Support personnel.
1011011	Description: Custom video rendering does not support the currently set video data type. Possible reason: The buffer_type in the config in [enableCustomVideoRender] only supports raw_data, cv_pixel_buffer, encoded_data. For the [enableCustomVideoProcessing] interface, Windows platform only supports raw_data, Apple devices only support cv_pixel_buffer, Android platform supports gl_texture_2d and surface_texture. Handling suggestion: Select the correct video data type.
1011012	Description: [customVideoCaptureSendD3DTextureData] passed a texture not supported by the SDK. Possible reason: The texture corresponding to the device passed by [customVideoCaptureSendD3DTextureData] is not created by D3D11CreateDevice(0, D3D_DRIVER_TYPE_HARDWARE, NULL, ......). Handling suggestion: [customVideoCaptureSendD3DTextureData] passes in the texture created by D3D11CreateDevice(0, D3D_DRIVER_TYPE_HARDWARE, NULL, ......).

When using SDK custom audio capture, custom audio rendering related API functions, developers can obtain relevant error codes from the callback parameter of the API (Java is anonymous class, OC is block, C++ is lambda), as follows:

Error Code Enumeration	Description
1012001	Description: Unsupported custom audio capture source type. Possible reason: Only channel_aux supports zego_audio_source_type_media_player. Handling suggestion: Select the correct custom audio capture source type.
1012002	Description: Custom audio capture function not enabled. Possible reason: Custom audio capture function not enabled. Handling suggestion: Please ensure that the custom audio IO function for the specified publishing stream channel is enabled.
1012003	Description: Custom audio rendering function not enabled. Possible reason: Custom audio rendering function not enabled. Handling suggestion: Please ensure that the custom audio IO function is enabled.
1012004	Description: Failed to set custom audio capture and rendering. Possible reason: Failed to set custom audio capture and rendering. Handling suggestion: Please ensure to call before starting the engine (ensure to call before `startPreview`/`startPublishingStream`/`startPlayingStream`).
1012010	Description: Sample rate parameter illegal. Possible reason: Recording mixing results with capture and rendering do not support 8000, 22050, 24000 sample rates. Handling suggestion: Please confirm whether the sample rate parameter value allowed by the interface is legal.

Error codes related to the process of using SDK media publisher related APIs are as follows:

Error Code Enumeration	Description
1013000	Description: The media publisher instance has not been created. Possible reason: The media publisher instance has not been created. Handling suggestion: Call [createMediaDataPublisher] to create the media publisher instance.
1013001	Description: This error code has been deprecated. Possible reason: None. Handling suggestion: None.
1013002	Description: This error code has been deprecated. Possible reason: None. Handling suggestion: None.
1013003	Description: File decoding exception. Possible reason: Invalid media file. Handling suggestion: Check whether the passed file is a valid media file; check whether the passed file format is in the list of file formats supported by the media player. For details, refer to /real-time-video-android-java/other-capability/media-player.
1013004	Description: Timestamp error. Possible reason: The timestamp of the next frame is smaller than the timestamp of the previous frame. Handling suggestion: Please provide the media file and contact ZEGOCLOUD Technical Support.
1013005	Description: Media publisher instances exceed the maximum limit. Possible reason: The number of media publisher created instances exceeds the maximum limit. Handling suggestion: Check whether the number of created media publisher instances exceeds the maximum limit. The maximum allowed number of instances is 1.

Error codes related to the process of using SDK audio effect player related APIs are as follows:

Error Code Enumeration	Description
1014000	Description: The audio effect player instance has not been created. Possible reason: The audio effect player instance has not been created. Handling suggestion: Please create the audio effect player instance (createAudioEffectPlayer) first before using the audio effect player.
1014001	Description: Failed to load audio effect resource. Possible reason: Invalid audio effect file. Handling suggestion: Check whether the passed file format is in the list of file formats supported by the audio effect player. For details, refer to /real-time-video-android-java/other/audio-effect-player.
1014002	Description: Failed to play audio effect. Possible reason: Invalid audio effect file. Handling suggestion: Check whether the passed file format is in the list of file formats supported by the audio effect player. For details, refer to /real-time-video-android-java/other/audio-effect-player.
1014003	Description: Failed to set audio effect playback progress. Possible reason: The set audio effect playback progress value exceeds the audio effect file playback duration range. Handling suggestion: Check whether the passed audio effect playback progress value is within the audio effect file playback duration range.
1014004	Description: Audio effect player created instances exceed the maximum limit. Possible reason: The number of audio effect player created instances exceeds the maximum limit. Handling suggestion: Check whether the number of created audio effect player instances exceeds the maximum limit. The maximum allowed number of instances is 1.

Error codes related to the process of using SDK utility tools (such as performance monitoring, network speed testing, etc.) related APIs are as follows:

Error Code Enumeration	Description
1015001	Description: Network connectivity test failed. Possible reason: Not connected to the network. Handling suggestion: Check whether you can normally access the Internet.
1015002	Description: Failed to connect to network speed test server. Possible reason: Not connected to the network. Handling suggestion: Check whether you can normally access the Internet.
1015003	Description: RTP timeout. Possible reason: Not connected to the network. Handling suggestion: Check whether you can normally access the Internet.
1015004	Description: Server ended network speed test. Possible reason: Network speed test took too long. Handling suggestion: End network speed test within 30 seconds.
1015005	Description: Network speed test has stopped. Possible reason: Did not actively stop network speed test before starting to publish stream. Handling suggestion: End network speed test (stopNetworkSpeedTest) before publishing stream.
1015006	Description: Network speed test has stopped. Possible reason: Did not actively stop network speed test before starting to play stream. Handling suggestion: End network speed test (stopNetworkSpeedTest) before playing stream.
1015009	Description: Internal exception caused network speed test error. Possible reason: Internal exception. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1015031	Description: Invalid system performance monitoring interval time. Possible reason: The set system performance monitoring interval is out of range. Handling suggestion: Check whether the system performance monitoring interval exceeds the range. Valid value range is [1000, 10000].
1015032	Description: Logging in to room causes network test to stop. Possible reason: Already logged in to room. Handling suggestion: Since network testing will occupy bandwidth, please conduct it before logging in to the room.
1015033	Description: Failed to start dumping data. Possible reason: Audio/video engine internal error. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1015034	Description: Already started dumping data. Possible reason: Repeatedly called [startDumpData]. Handling suggestion: Stop or cancel the previous dumping data task.
1015035	Description: No data to dump. Possible reason: Audio/video engine internal error. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1015036	Description: Failed to create dumping data folder. Possible reason: No read/write permission or disk is full. Handling suggestion: Check whether the disk still has space.
1015037	Description: Upload module internal error. Possible reason: Upload module internal error occurred. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1015038	Description: Dumped data exceeds the maximum upload limit error. Possible reason: Dumped data is too large, exceeding the upload module limit. Handling suggestion: Please contact ZEGOCLOUD Technical Support and manually report to ZEGO.

Error codes related to the process of using SDK range audio related APIs are as follows:

Error Code Enumeration	Description
1016000	Description: Function call failed. Possible reason: No range audio instance created. Handling suggestion: Create range audio instance.
1016001	Description: Failed to create range audio. Possible reason: Instances exceed the maximum limit. Handling suggestion: Use existing range audio instances.
1016002	Description: Failed to create range audio. Possible reason: Cannot use range audio in multi-room mode. Handling suggestion: Set single-room mode.
1016003	Description: Failed to set team ID. Possible reason: The input team ID exceeds the maximum limit. Handling suggestion: Enter a string less than 64 bytes.
1016004	Description: Failed to set team ID. Possible reason: The input team ID contains illegal characters. Handling suggestion: Only supports numbers, English characters, and '~', '!', '@', '#', '$', '%', '^', '&', '*', '(', ')', '_', '+', '=', '-', ',', ';', ',', '.', '<', '>', '/', ''.

Error codes related to the process of using SDK copyrighted music related APIs are as follows:

Error Code Enumeration	Description
1017000	Description: command parameter invalid. Possible reason: The input command parameter is empty. Handling suggestion: Please pass in the correct command parameter, see https://www.zegocloud.com/docs/online-ktv-android/client-api/send-extended-request#1 for details.
1017001	Description: params parameter invalid. Possible reason: The input params parameter is empty. Handling suggestion: Please pass in the correct params parameter.
1017002	Description: song_id parameter invalid. Possible reason: The input song_id parameter is empty. Handling suggestion: Please pass in the correct song_id parameter, see https://www.zegocloud.com/docs/online-ktv-android/client-api/send-extended-request#1 for details.
1017003	Description: share_token parameter invalid. Possible reason: The input share_token parameter is empty. Handling suggestion: Please pass in the correct share_token parameter. share_token can be obtained by requesting resource [requestResource].
1017004	Description: resource_id parameter invalid. Possible reason: The input resource_id parameter is empty. Handling suggestion: Please pass in the correct resource_id parameter. resource_id can be obtained by requesting resource/song accompaniment [requestResource] [getSharedResource].
1017005	Description: start_position parameter invalid. Possible reason: The input start_position parameter is invalid. Handling suggestion: Please pass in a start_position parameter with a positive value, range [0, song duration].
1017006	Description: position parameter invalid. Possible reason: The input position parameter is invalid. Handling suggestion: Please pass in a position parameter with a positive value, range [0, song duration].
1017007	Description: volume parameter invalid. Possible reason: The input Volume parameter is invalid. Handling suggestion: Please pass in the correct Volume parameter, range [0, 200].
1017008	Description: krcToken parameter invalid. Possible reason: The input krcToken parameter is empty. Handling suggestion: Please pass in the correct krcToken parameter. krcToken can be obtained by obtaining resource [requestResource] [getSharedResource].
1017009	Description: Copyrighted music initialization authentication failed. Possible reason: Did not set AppSign or Token when using Token authentication. Handling suggestion: When using Token authentication, call [loginRoom] before calling [initCopyrightedMusic], or use AppSign authentication.
1017010	Description: Failed to request copyright service. Possible reason: Input parameter error or network reasons. Handling suggestion: Please pass in the correct calling parameters and retry.
1017011	Description: Local disk space insufficient. Possible reason: Local disk space insufficient. Handling suggestion: Please clean up local files to ensure sufficient disk space.
1017012	Description: Downloading in progress. Possible reason: Downloading the same resource. Handling suggestion: Please wait for the resource download to complete.
1017013	Description: Resource file lost. Possible reason: Resource file has been deleted. Handling suggestion: Please reload the resource file.
1017014	Description: Expired resource file. Possible reason: Resource file has exceeded its validity period. Handling suggestion: Please reorder the song or accompaniment.
1017015	Description: Invalid resource file. Possible reason: File is corrupted. Handling suggestion: Please call [download] to re-download the resource file.
1017016	Description: Download cancelled. Possible reason: Actively cancelled download by calling [cancelDownload].
1017018	Description: Resource ID not authorized. Possible reason: The resource ID was not obtained through [requestResource] or [getSharedResource] interface. Handling suggestion: Please call [requestResource] or [getSharedResource] interface to order songs and obtain a valid resource ID first.
1017019	Description: Copyright resource expired. Possible reason: Copyright resource has expired. Handling suggestion: Please reorder this copyright resource.
1017020	Description: This resource does not support this method. Possible reason: Resource ID passed in incorrectly. Handling suggestion: Please pass in the correct resource ID.
1017030	Description: Music has no copyright, unable to listen to and sing songs. Possible reason: Music has no copyright. Handling suggestion: Please select copyrighted music.
1017031	Description: Music has no accompaniment permission, can only listen to songs, cannot sing. Possible reason: Music has no accompaniment permission. Handling suggestion: Please select music with lyrics and composition permission.
1017032	Description: Not a monthly member. Possible reason: Monthly member subscription not activated. Handling suggestion: Please activate the user monthly member mode or use the pay-per-use mode to order songs.
1017033	Description: No accompaniment resource. Possible reason: The song has no accompaniment resource. Handling suggestion: Please select a song with accompaniment resources.
1017034	Description: Resource not found. Possible reason: Resource not found. Handling suggestion: Please select another song.
1017040	Description: Parameter illegal. Possible reason: The passed parameter is incorrect. Handling suggestion: Please enter the correct parameters.
1017041	Description: AppID unavailable. Possible reason: The current AppID does not support copyrighted music function. Handling suggestion: Please contact ZEGOCLOUD Technical Support.
1017042	Description: Unsupported billing mode. Possible reason: Unsupported billing mode. Handling suggestion: Please select the correct billing mode.
1017043	Description: Unreasonable access. Possible reason: Monthly member using pay-per-use mode to order songs. Handling suggestion: Please select the correct billing mode.
1017044	Description: Share token expired. Possible reason: Share token has expired. Handling suggestion: Please select an unexpired share token to obtain resources.
1017045	Description: Share token illegal. Possible reason: Share token is illegal. Handling suggestion: Please select the correct share token to obtain resources.
1017046	Description: krcToken illegal. Possible reason: krcToken is illegal. Handling suggestion: Please select the correct krcToken to obtain krc format lyrics.
1017047	Description: krcToken expired. Possible reason: krcToken has expired. Handling suggestion: Please select an unexpired krcToken to obtain krc format lyrics.
1017048	Description: Failed to get lyrics. Possible reason: Lyrics not found. Handling suggestion: Please try again later.
1017049	Description: Failed to get pitch line. Possible reason: Pitch line not found or resource has been removed from shelves. Handling suggestion: Please select the correct song.
1017050	Description: The resource has not been shared in the room. Possible reason: No user in the room has shared this resource. Handling suggestion: Please have any user in the room call the [requestResource] interface to request the resource and share it.
1017051	Description: The free acquisition count of this resource in the room has been exhausted. Possible reason: 1. Cannot obtain the resource shared by yourself again; 2. Already obtained the shared resource. Handling suggestion: Please use the already obtained resource, or use [requestResource] to share the resource again.
1017052	Description: This copyright provider is unavailable. Possible reason: The corresponding copyright provider has not been activated. Handling suggestion: Please pass in the correct copyright provider ID.
1017053	Description: This copyright provider does not support this method. Possible reason: Copyright provider ID passed in incorrectly. Handling suggestion: Please pass in the correct copyright provider ID.
1017054	Description: This room ID has not logged in. Possible reason: Room ID passed in incorrectly. Handling suggestion: If not using copyright in a multi-room scenario, you do not need to pass in roomID, otherwise please pass in the correct logged-in room ID.
1017071	Description: Invalid copyright provider ID. Possible reason: Copyright provider ID passed in incorrectly. Handling suggestion: Please pass in the correct copyright provider ID.
1017072	Description: This copyright provider does not support this song ID. Possible reason: The copyright provider music library does not have this song ID. Handling suggestion: Please pass in the correct song ID.
1017073	Description: Invalid master ID. Possible reason: When choosing pay-by-room billing, master ID was not passed in. Handling suggestion: Please pass in the correct master ID.
1017074	Description: page parameter invalid when searching multiple copyrights. Possible reason: When calling multiple copyright search for the first time, page parameter must be 1. Handling suggestion: Please pass in the correct page.
1017075	Description: The resource has no pitch line. Possible reason: The resource has no pitch line. Handling suggestion: Please pass in the correct song ID.
1017076	Description: Unsupported scene ID. Possible reason: Unsupported scene ID. Handling suggestion: Please pass in the scene ID of the activated scenario.
1017077	Description: Unsupported top ID. Possible reason: Passed an unsupported top ID when getting top list songs. Handling suggestion: Please pass in the correct top ID.
1017094	Description: Failed to load copyrighted music plugin. Possible reason: The program running path does not contain the copyrighted music plugin dynamic library. Handling suggestion: Please configure the copyrighted music plugin dynamic library dependency correctly.
1017095	Description: Copyrighted music module does not support this function. Possible reason: The copyrighted music module does not support this function on the current platform. Handling suggestion: Please contact ZEGOCLOUD Technical Support to handle.
1017096	Description: Copyrighted music module not initialized. Possible reason: Did not call the [initCopyrightedMusic] method to initialize the copyright module. Handling suggestion: Please call the [initCopyrightedMusic] method first.
1017097	Description: System busy. Possible reason: System busy. Handling suggestion: Please retry.
1017098	Description: Network exception caused failure. Possible reason: Internal unknown error. Handling suggestion: Please contact ZEGOCLOUD Technical Support to handle.
1017099	Description: System internal exception caused failure. Possible reason: Internal unknown error. Handling suggestion: Please contact ZEGOCLOUD Technical Support to handle.

Error codes related to the process of using SDK voice activity detection related APIs are as follows:

Error Code Enumeration	Description
1018000	Description: SDK internal returned null pointer.
1018001	Description: Function call failed. Possible reason: No audio packet detection class instance created. Handling suggestion: Create audio packet detection class instance.

Error codes related to the process of using SDK range scene related APIs are as follows:

Error Code Enumeration	Description
1019000	Description: Interface call failed. Possible reason: Illegal parameter or SDK does not include RangeScene module. Handling suggestion: Please confirm whether the SDK includes the RangeScene module and check parameters.
1019001	Description: The range scene instance has not been created. Possible reason: The range scene instance has not been created. Handling suggestion: Please create the range scene instance [createRangeScene] first before using the range scene.
1019002	Description: Not logged in to scene. Possible reason: Not logged in to scene. Handling suggestion: Please call [loginScene] to login to the scene.
1019003	Description: Used unsupported function. Possible reason: Used state synchronization interface without activating state synchronization function. Handling suggestion: If you want to use state synchronization interface, please activate the state synchronization function.
1019020	Description: Retry login to scene exceeded maximum retry time. Possible reason: Network reasons. Handling suggestion: Please check whether the network is normal or switch the network environment.
1019021	Description: Scene connection temporarily interrupted. Possible reason: Network reasons. Handling suggestion: Please wait or check whether the network is normal.
1019022	Description: Token verification failed. Possible reason: The parameters passed when generating Token are inconsistent with SDK usage. Handling suggestion: Please use the correctly regenerated Token.
1019027	Description: Token expired. Possible reason: Token has expired, or the validity period parameter type passed when generating Token is incorrect. Handling suggestion: Regenerate Token.
1019020	Description: Coordinates are out of range. Possible reason: Coordinates exceed the scene range. Handling suggestion: Please pass in the correct coordinates.
1019021	Description: Item has already been created. Possible reason: Item has already been created. Handling suggestion: Item has already been created, no need to create the item again.
1019022	Description: Item bound users exceed the maximum limit. Possible reason: Item bound users exceed the maximum limit. Handling suggestion: Item bound users exceed the maximum limit, please try again later.
1019023	Description: Item does not exist. Possible reason: Item does not exist. Handling suggestion: Please create the item first.
1019024	Description: Item not bound. Possible reason: Item not bound. Handling suggestion: Please bind the item first.
1019025	Description: Item is being operated by someone else. Possible reason: Item is being operated by someone else. Handling suggestion: Please try again later.
1019026	Description: Item binding capacity exceeds the maximum limit. Possible reason: Item binding capacity exceeds the maximum limit. Handling suggestion: Use capacity that does not exceed the binding maximum capacity limit to create items.
1019027	Description: User binding items reached the maximum limit. Possible reason: User binding items reached the maximum limit. Handling suggestion: Please unbind some temporarily unused items first.
1019028	Description: Item is outside the user's field of view. Possible reason: Item is outside the user's field of view. Handling suggestion: Please operate items within the user's field of view.
1019030	Description: Range scene created instances exceed the maximum limit. Possible reason: Range scene created instances exceed the maximum limit, at most 1 instance can be created. Handling suggestion: Range scene can create at most 1 instance. Please ensure that the number of created range scene instances does not exceed the maximum limit.
1019031	Description: Range scene joined teams exceed the maximum limit. Possible reason: Range scene joined teams exceed the maximum limit, default allows joining 5 teams. Handling suggestion: Range scene default allows joining at most 5 teams. Please ensure that the number of joined teams does not exceed the maximum limit.
1019032	Description: Team ID is occupied. Possible reason: The team ID provided when joining a team in the range scene is occupied. Handling suggestion: Provide a new team ID to join the team.
1019033	Description: Team ID does not exist. Possible reason: The wrong team ID was provided when leaving a team in the range scene. Handling suggestion: Provide the correct team ID when leaving the team.
1019099	Description: System internal exception caused failure. Possible reason: Internal unknown error. Handling suggestion: Please contact ZEGOCLOUD Technical Support to handle.

Error codes related to the process of using SDK screen capture related APIs are as follows:

Error Code Enumeration	Description
1020000	Description: Failed to start screen capture. Possible reason: User refused to grant the application screen capture permission. Handling suggestion: Allow the application to capture screen permission.
1020001	Description: Failed to start screen capture. Possible reason: Current system version does not support screen capture. Handling suggestion: Use Android 5 (API level 21) or above system version.
1020002	Description: Failed to start screen capture. Possible reason: Unable to load screen sharing module. Handling suggestion: Please introduce screen sharing module resources or contact technical support.
1020003	Description: Function call failed. Possible reason: No screen capture source instance created. Handling suggestion: Create screen capture source instance.
1020004	Description: Failed to create screen capture source. Possible reason: Instances exceed the maximum limit. Handling suggestion: Use the existing screen capture instance or destroy the previous instance.
1020005	Description: System internal exception caused failure. Possible reason: Internal unknown error. Handling suggestion: Please contact ZEGOCLOUD Technical Support to handle.

Error codes related to the process of using SDK AI voice changer related APIs are as follows:

Error Code Enumeration	Description
1021000	Description: Function call failed. Possible reason: No AI voice changer instance created. Handling suggestion: Create AI voice changer instance.
1021001	Description: Failed to create AI voice changer instance. Possible reason: Instances exceed the maximum limit. Handling suggestion: Use the existing AI voice changer instance or destroy the previous instance.
1021002	Description: System internal exception caused failure. Possible reason: Internal unknown error. Handling suggestion: Please contact ZEGOCLOUD Technical Support to handle.
1021003	Description: AI voice changer not initialized. Possible reason: AI voice changer was not initialized before use. Handling suggestion: Please initialize the AI voice changer first before using.
1021004	Description: Failed to initialize AI voice changer. Possible reason: User ID was not set before use or AI voice changer service expired causing initialization failure. Handling suggestion: Please use after setting the user ID or contact ZEGOCLOUD Technical Support to handle.
1021005	Description: Resource file not downloaded. Possible reason: Resource file was not downloaded. Handling suggestion: Ensure the resource file has been normally downloaded before using the AI voice changer function.
1021006	Description: Failed to download resource file. Possible reason: Network connection unstable. Handling suggestion: Please check whether the network connection is normal.
1021007	Description: Device does not support running AI voice changer function. Possible reason: Due to poor device performance, it does not support running AI voice changer function. Handling suggestion: The current device does not enable the AI voice changer function.

Common Error Codes

1000xxx General Error Codes

1001xxx Error Codes Related to SDK Internal Validation During Debugging Phase

1002xxx Room Related Error Codes

1003xxx Publishing Stream Related Error Codes

1004xxx Playing Stream Related Error Codes

1005xxx Stream Mixing Error

1006xxx Device Error

1007xxx SDK Internal Pre-Audio/Video Processing Related Errors

1008xxx Media Player Errors

1009xxx IM Error

1010xxx Media Recording Related Errors

1011xxx Custom Video Capture, Custom Video Rendering Related Errors

1012xxx Custom Audio Capture, Custom Audio Rendering Related Errors

1013xxx Media Publisher Related Errors

1014xxx Audio Effect Player Related Errors

1015xxx Utility Related Errors

1016xxx Utility Related Errors

1017xxx Copyrighted Music Related Errors

1018xxx Voice Activity Detection Related Errors

1019xxx Range Scene Related Errors

1020xxx Screen Capture Related Errors

1021xxx AI Voice Changer Related Errors