Skip to main content
Android
iOS
macOS
Web
Windows
Electron
Flutter
React Native
Python
React JS
Unity
Unreal Engine
Unreal (Blueprint)

SDK error codes

When interacting with the Agora API, the Voice SDK may return an error code. Receiving an error code indicates that the SDK has encountered an unrecoverable error that necessitates intervention from your app.

This page provides descriptions for common error codes along with the associated reasons and their corresponding solutions. For error codes without predefined solutions, contact technical support for assistance.

The error codes listed in this section apply to Agora RTC v4.x SDK on the following platforms:

  • Native platforms: Android, iOS, macOS, Windows.
  • Third-party frameworks (that is, third-party platforms based on native platform encapsulation): Electron, Unity, React Native, Flutter.

During the operation of Agora SDK, error codes may be returned in the following ways:

  • In the return value of a failed method call.
  • Through the onError callback.
Information
  • When the SDK returns an error code, it may return a negative number. This negative number corresponds to the positive integer in the error code. For example, if it returns -2, it corresponds to 2 in the error code.
  • The API names in this article are based on the C++ API. The API names for other platforms may be different. Please refer to the API documentation for the corresponding platform.

Common error codes

Error codeDescription
0No errors.
1General error (no clearly categorized cause of error). Please call the method again.
2An invalid parameter was set in the method. For example, the specified channel name contains illegal characters. Please reset the parameters.
3The SDK is not ready yet. There are usually the following reasons:
  • RtcEngine initialization failed. Please reinitialize RtcEngine.
  • The user has not joined the channel when the method is called, please check the method calling logic.
  • Please check the calling logic of the method.
  • The user has not left the channel when the rate or complain method is called, please check the method calling logic.
  • Audio module is not enabled.
  • Incomplete assembly.
4The current state of RtcEngine does not support this operation. There are generally the following reasons:
  • Incorrect encryption mode set when using built-in encryption.
  • Failed to load external encryption library. Please check if the enumeration value for encryption is correct, or reload the external encryption library.
5The method call is rejected. There are generally the following reasons:
  • RtcEngine initialization failed. Please reinitialize RtcEngine.
  • The channel name was set to the empty character "" when joining a channel. Please reset the channel name.
  • In a multi-channel scenario, the channel name set when the joinChannel method was called to join a channel already exists. Please reset the channel name.
  • In a multi-channel scenario, the channel name set when the joinChannelEx method is called to join a channel already exists. Please reset the channel name.
6The buffer size is not large enough to hold the returned data.
7The method is called before RtcEngine is initialized. Please make sure that the RtcEngine object has been created and initialized before calling the method.
8The current state is invalid. Please check the SDK callback logs to find the exact reason.
9There is no permission to operate. Please check whether the user has granted the app permission to use audio/video devices.
10Method call timed out. Some method calls require the SDK to return results, and this error occurs if the SDK takes too long to process the event and does not return for more than 10 seconds.
17Joining a channel is rejected. There are usually the following reasons:
  • The user is already in the channel. Agora recommends using the onConnectionStateChanged callback to determine if the user is in the channel. Do not call this method again to join the channel unless you receive a CONNECTION_STATE_DISCONNECTED(1) status.
  • A user who calls startEchoTest for a call test tries to join the channel without calling stopEchoTest to end the current test. After starting a call test, you need to call stopEchoTest to end the current test before joining the channel.
18Failed to leave the channel. There are generally the following reasons:
  • The user has already left the channel, and this error is returned when the method to exit the channel, such as leaveChannel, is called again. Stop calling this method.
  • The exit channel method such as leaveChannel is called when the user has not joined the channel yet. No additional action is needed in this case.
19The resource is occupied and cannot be reused.
20The SDK abandons the request, possibly due to too many requests.
21Specific firewall settings on Windows cause the RtcEngine initialization to fail and then crash.
22The SDK failed to allocate resources, possibly because the app takes up too many resources or the system resources are exhausted.
101Not a valid App ID, please rejoin the channel with a valid App ID.
102Not a valid channel name. The possible reason is that the parameter data type set is incorrect. Please rejoin the channel with a valid channel name.
103Cannot get server resources for the current region. Please try to specify a different region when initializing RtcEngine.
109The currently used Token has expired and is no longer valid. Please generate a new Token on the server side and call renewToken to update the Token.
Deprecated
This error code is deprecated. Please use CONNECTION_CHANGED_TOKEN_EXPIRED(9) in the onConnectionStateChanged callback instead.
110Token is invalid. There are generally the following reasons:
  • App certificate is enabled in the Agora Console, but App ID + Token authentication is not used. When App certificate is enabled in the project, you must use Token authentication.
  • The uid field entered when generating the Token does not match the uid entered when the user joined the channel.
Deprecated
This error code is deprecated. Please use CONNECTION_CHANGED_INVALID_TOKEN(8) in the onConnectionStateChanged callback instead.
111The network connection is interrupted. After the SDK established a connection with the server, the network connection was lost for more than 4 seconds.
112Network connection lost. The network connection was interrupted and the SDK could not connect to the server within 10 seconds.
119User failed to switch roles, please try to join the channel again.
120Decryption failed. It is possible that the user used the wrong password when joining the channel. Please check the password the user entered when joining the channel, or direct the user to try to rejoin the channel.
121The user ID is invalid.
123This user has been banned by the server. This error is reported when the user is kicked out by the server.
134Invalid user account, possibly because invalid parameters are set.
Error codeDescription
1005An unspecified error occurred in the audio device. Check if the audio device is occupied by another application or try to re-enter the channel.
1008An error occurred while initializing the playback device. Check if the playback device is occupied by another application or try to re-enter the channel.
1009Error starting the playback device. Please check if the playback device is working properly.
1010Error stopping the playback device.
1011Error initializing the recording device. Please check if the recording device is working properly, or try to re-enter the channel.
1012Error starting the recording device. Please check if the recording device is working properly.
1013Error stopping the recording device.
Error codeDescription
113The user was not in the channel when the sendStreamMessage method was called.
114When sendStreamMessage was called, the length of the data sent was greater than 1024 bytes.
115The frequency of sending data exceeded the limit (6 KB/s) when calling sendStreamMessage.
116Number of data streams exceeding the limit (5) were created when createDataStream was called.
117Data stream send timeout.

Other error codes

Error codeDescription
130The SDK does not support pushing encrypted streams to a CDN.
1001Failed to load the media engine.
1501There is no permission to use the camera. Please check if camera permission has been turned on.

Voice Calling