ERROR_CODE_TYPE

Error codes.

An error code indicates that the SDK encountered an unrecoverable error that requires application intervention. For example, an error is returned when the camera fails to open, and the app needs to inform the user that the camera cannot be used.

Enumerator

ERR_OK
0: No error.
ERR_FAILED
1: General error with no classified reason. Try calling the method again.
ERR_INVALID_ARGUMENT
2: An invalid parameter is used. For example, the specified channel name includes illegal characters. Reset the parameter.
ERR_NOT_READY
3: The SDK is not ready. Possible reasons include the following:
  • The initialization of IRtcEngine fails. Reinitialize the IRtcEngine.
  • No user has joined the channel when the method is called. Check the code logic.
  • The user has not left the channel when the rate or complain method is called. Check the code logic.
  • The audio module is disabled.
  • The program is not complete.
ERR_NOT_SUPPORTED
4: The IRtcEngine does not support the request. Possible reasons include the following:
  • The built-in encryption mode is incorrect, or the SDK fails to load the external encryption library. Check the encryption mode setting, or reload the external encryption library.
ERR_REFUSED
5: The request is rejected. Possible reasons include the following:
  • The IRtcEngine initialization fails. Reinitialize the IRtcEngine.
  • The channel name is set as the empty string "" when joining the channel. Reset the channel name.
  • When the joinChannelEx method is called to join multiple channels, the specified channel name is already in use. Reset the channel name.
ERR_BUFFER_TOO_SMALL
6: The buffer size is insufficient to store the returned data.
ERR_NOT_INITIALIZED
7: A method is called before the initialization of IRtcEngine. Ensure that the IRtcEngine object is initialized before using this method.
ERR_INVALID_STATE
8: Invalid state.
ERR_NO_PERMISSION
9: Permission to access is not granted. Check whether your app has access to the audio and video device.
ERR_TIMEDOUT
10: A timeout occurs. Some API calls require the SDK to return the execution result. This error occurs if the SDK takes too long (more than 10 seconds) to return the result.
ERR_JOIN_CHANNEL_REJECTED
17: The request to join the channel is rejected. Possible reasons include the following:
  • The user is already in the channel. Agora recommends that you use the onConnectionStateChanged callback to determine whether the user exists in the channel. Do not call this method to join the channel unless you receive the CONNECTION_STATE_DISCONNECTED(1) state.
  • After calling startEchoTest [3/3] for the call test, the user tries to join the channel without calling stopEchoTest to end the current test. To join a channel, the call test must be ended by calling stopEchoTest.
ERR_LEAVE_CHANNEL_REJECTED
18: Fails to leave the channel. Possible reasons include the following:
  • The user has left the channel before calling the leaveChannel [2/2] method. Stop calling this method to clear this error.
  • The user calls the leaveChannel [2/2] method to leave the channel before joining the channel. In this case, no extra operation is needed.
ERR_ALREADY_IN_USE
19: Resources are already in use.
ERR_ABORTED
20: The request is abandoned by the SDK, possibly because the request has been sent too frequently.
ERR_INIT_NET_ENGINE
21: The IRtcEngine fails to initialize and has crashed because of specific Windows firewall settings.
ERR_RESOURCE_LIMITED
22: The SDK fails to allocate resources because your app uses too many system resources or system resources are insufficient.
ERR_INVALID_APP_ID
101: The specified App ID is invalid. Rejoin the channel with a valid App ID.
ERR_INVALID_CHANNEL_NAME
102: The specified channel name is invalid. A possible reason is that the parameter's data type is incorrect. Rejoin the channel with a valid channel name.
ERR_NO_SERVER_RESOURCES
103: Fails to get server resources in the specified region. Try another region when initializing IRtcEngine.
ERR_TOKEN_EXPIRED
109: The current token has expired. Apply for a new token on the server and call renewToken.
Deprecated:
This enumerator is deprecated. Use CONNECTION_CHANGED_TOKEN_EXPIRED(9) in the onConnectionStateChanged callback instead.
ERR_INVALID_TOKEN
110: Invalid token. Typical reasons include the following:
  • App Certificate is enabled in Agora Console, but the code still uses App ID for authentication. Once App Certificate is enabled for a project, you must use token-based authentication.
  • The uid used to generate the token is not the same as the uid used to join the channel.
Deprecated:
This enumerator is deprecated. Use CONNECTION_CHANGED_INVALID_TOKEN(8) in the onConnectionStateChanged callback instead.
ERR_CONNECTION_INTERRUPTED
111: The network connection is interrupted. The SDK triggers this callback when it loses connection with the server for more than four seconds after the connection is established.
ERR_CONNECTION_LOST
112: The network connection is lost. Occurs when the SDK cannot reconnect to Agora's edge server 10 seconds after its connection to the server is interrupted.
ERR_NOT_IN_CHANNEL
113: The user is not in the channel when calling the sendStreamMessage method.
ERR_SIZE_TOO_LARGE
114: The data size exceeds 1 KB when calling the sendStreamMessage method.
ERR_BITRATE_LIMIT
115: The data bitrate exceeds 6 KB/s when calling the sendStreamMessage method.
ERR_TOO_MANY_DATA_STREAMS
116: More than five data streams are created when calling the createDataStream [2/2] method.
ERR_STREAM_MESSAGE_TIMEOUT
117: The data stream transmission times out.
ERR_SET_CLIENT_ROLE_NOT_AUTHORIZED
119: Switching roles fails, try rejoining the channel.
ERR_DECRYPTION_FAILED
120: Decryption fails. The user might have entered an incorrect password to join the channel. Check the entered password, or tell the user to try rejoining the channel.
ERR_INVALID_USER_ID
121: The user ID is invalid.
ERR_CLIENT_IS_BANNED_BY_SERVER
123: The user is banned from the server.
ERR_ENCRYPTED_STREAM_NOT_ALLOWED_PUBLISH
130: The SDK does not support pushing encrypted streams to CDN.
ERR_INVALID_USER_ACCOUNT
134: The user account is invalid, possibly because it contains invalid parameters.
ERR_LOAD_MEDIA_ENGINE
1001: The SDK fails to load the media engine.
ERR_ADM_GENERAL_ERROR
1005: A general error occurs (no specified reason). Check whether the audio device is already in use by another app, or try rejoining the channel.
ERR_ADM_INIT_PLAYOUT
1008: An error occurs when initializing the playback device. Check whether the playback device is already in use by another app, or try rejoining the channel.
ERR_ADM_START_PLAYOUT
1009: An error occurs when starting the playback device. Check the playback device.
ERR_ADM_STOP_PLAYOUT
1010: An error occurs when stopping the playback device.
ERR_ADM_INIT_RECORDING
1011: An error occurs when initializing the recording device. Check the recording device, or try rejoining the channel.
ERR_ADM_START_RECORDING
1012: An error occurs when starting the recording device. Check the recording device.
ERR_ADM_STOP_RECORDING
1013: An error occurs when stopping the recording device.
ERR_VDM_CAMERA_NOT_AUTHORIZED
1501: Permission to access the camera is not granted. Check whether permission to access the camera permission is granted.