Agora C++ API Reference for All Platforms

8: The specified view is invalid. Specify a view when using the video call function.

16: Failed to initialize the video function, possibly caused by a lack of resources. The users cannot see the video while the voice communication is not affected.

20: The request is pending, usually due to some module not being ready, and the SDK postponed processing the request.

103: No channel resources are available. Maybe because the server cannot allocate any channel resource.

104: A timeout occurs when looking up the channel. When joining a channel, the SDK looks up the specified channel. This warning usually occurs when the network condition is too poor for the SDK to connect to the server.

DEPRECATED 105: The server rejects the request to look up the channel. The server cannot process this request or the request is illegal.

Deprecated as of v2.4.1. Use CONNECTION_CHANGED_REJECTED_BY_SERVER(10) in the onConnectionStateChanged callback instead.

106: A timeout occurs when opening the channel. Once the specific channel is found, the SDK opens the channel. This warning usually occurs when the network condition is too poor for the SDK to connect to the server.

107: The server rejects the request to open the channel. The server cannot process this request or the request is illegal.

111: A timeout occurs when switching to the live video.

118: A timeout occurs when setting the client role in the live broadcast profile.

121: The ticket to open the channel is invalid.

122: Try connecting to another server.

701: An error occurs in opening the audio mixing file.

1014: Audio Device Module: a warning occurs in the playback device.

1016: Audio Device Module: a warning occurs in the recording device.

1019: Audio Device Module: no valid audio data is collected.

1020: Audio Device Module: the playback device fails.

1021: Audio Device Module: the recording device fails.

1025: The audio playback or recording is interrupted by system events (such as a phone call).

1029: During a call, the audio session category should be set to AVAudioSessionCategoryPlayAndRecord, and RtcEngine monitors this value. If the audio session category is set to other values, this warning code is triggered and RtcEngine will forcefully set it back to AVAudioSessionCategoryPlayAndRecord.

1031: Audio Device Module: the recorded audio voice is too low.

1032: Audio Device Module: the playback audio voice is too low.

1040: Audio device module: An exception occurs with the audio drive. Solutions:

• Disable or re-enable the audio device.
• Re-enable your device.
• Update the sound card drive.

1051: Audio Device Module: howling is detected.

1052: Audio Device Module: the device is in the glitch state.

1053: Audio Device Module: the underlying audio settings have changed.

1323: Audio device module: No available playback device. Solution: Plug in the audio device.

Audio device module: The capture device is released improperly. Solutions:

• Disable or re-enable the audio device.
• Re-enable your device.
• Update the sound card drive.

1610: Super-resolution warning: the original video dimensions of the remote user exceed 640 × 480.

1611: Super-resolution warning: another user is using super resolution.

1612: The device is not supported.

0: No error occurs.

1: A general error occurs (no specified reason).

2: An invalid parameter is used. For example, the specific channel name includes illegal characters.

3: The SDK module is not ready. Possible solutions:

• Check the audio device.
• Check the completeness of the application.
• Re-initialize the RTC engine.

4: The SDK does not support this function.

5: The request is rejected.

6: The buffer size is not big enough to store the returned data.

7: The SDK is not initialized before calling this method.

9: No permission exists. Check if the user has granted access to the audio or video device.

10: An API method timeout occurs. Some API methods require the SDK to return the execution result, and this error occurs if the request takes too long (more than 10 seconds) for the SDK to process.

11: The request is canceled. This is for internal SDK use only, and it does not return to the application through any method or callback.

12: The method is called too often. This is for internal SDK use only, and it does not return to the application through any method or callback.

13: The SDK fails to bind to the network socket. This is for internal SDK use only, and it does not return to the application through any method or callback.

14: The network is unavailable. This is for internal SDK use only, and it does not return to the application through any method or callback.

15: No network buffers are available. This is for internal SDK internal use only, and it does not return to the application through any method or callback.

17: The request to join the channel is rejected. This error usually occurs when the user is already in the channel, and still calls the method to join the channel, for example, joinChannel.

18: The request to leave the channel is rejected.

This error usually occurs:

• When the user has left the channel and still calls leaveChannel to leave the channel. In this case, stop calling leaveChannel.
• When the user has not joined the channel and still calls leaveChannel to leave the channel. In this case, no extra operation is needed.

19: Resources are occupied and cannot be reused.

20: The SDK gives up the request due to too many requests.

21: In Windows, specific firewall settings can cause the SDK to fail to initialize and crash.

22: The application uses too much of the system resources and the SDK fails to allocate the resources.

101: The specified App ID is invalid. Please try to rejoin the channel with a valid App ID.

102: The specified channel name is invalid. Please try to rejoin the channel with a valid channel name.

DEPRECATED 109: Deprecated as of v2.4.1. Use CONNECTION_CHANGED_TOKEN_EXPIRED(9) in the onConnectionStateChanged callback instead.

The token expired due to one of the following reasons:

• Authorized Timestamp expired: The timestamp is represented by the number of seconds elapsed since 1/1/1970. The user can use the Token to access the Agora service within five minutes after the Token is generated. If the user does not access the Agora service after five minutes, this Token is no longer valid.
• Call Expiration Timestamp expired: The timestamp is the exact time when a user can no longer use the Agora service (for example, when a user is forced to leave an ongoing call). When a value is set for the Call Expiration Timestamp, it does not mean that the token will expire, but that the user will be banned from the channel.

DEPRECATED 110: Deprecated as of v2.4.1. Use CONNECTION_CHANGED_INVALID_TOKEN(8) in the onConnectionStateChanged callback instead.

The token is invalid due to one of the following reasons:

• The App Certificate for the project is enabled in Console, but the user is still using the App ID. Once the App Certificate is enabled, the user must use a token.
• The uid is mandatory, and users must set the same uid as the one set in the joinChannel method.

111: The internet connection is interrupted. This applies to the Agora Web SDK only.

112: The internet connection is lost. This applies to the Agora Web SDK only.

113: The user is not in the channel when calling the sendStreamMessage or getUserInfoByUserAccount method.

114: The size of the sent data is over 1024 bytes when the user calls the sendStreamMessage method.

115: The bitrate of the sent data exceeds the limit of 6 Kbps when the user calls the sendStreamMessage method.

116: Too many data streams (over 5 streams) are created when the user calls the createDataStream method.

117: The data stream transmission timed out.

119: Switching roles fail. Please try to rejoin the channel.

120: Decryption fails. The user may have used a different encryption password to join the channel. Check your settings or try rejoining the channel.

123: The client is banned by the server.

124: Incorrect watermark file parameter.

125: Incorrect watermark file path.

126: Incorrect watermark file format.

127: Incorrect watermark file information.

128: Incorrect watermark file data format.

129: An error occurs in reading the watermark file.

130: Encryption is enabled when the user calls the addPublishStreamUrl method (CDN live streaming does not support encrypted streams).

134: The user account is invalid.

151: CDN related errors. Remove the original URL address and add a new one by calling the removePublishStreamUrl and addPublishStreamUrl methods.

152: The host publishes more than 10 URLs. Delete the unnecessary URLs before adding new ones.

153: The host manipulates other hosts' URLs. Check your app logic.

154: An error occurs in Agora's streaming server. Call the addPublishStreamUrl method to publish the streaming again.

155: The server fails to find the stream.

156: The format of the RTMP stream URL is not supported. Check whether the URL format is correct.

1001: Fails to load the media engine.

1002: Fails to start the call after enabling the media engine.

DEPRECATED 1003: Fails to start the camera.

Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE(4) in the onConnectionStateChanged callback instead.

1004: Fails to start the video rendering module.

1005: A general error occurs in the Audio Device Module (no specified reason). Check if the audio device is used by another application, or try rejoining the channel.

1006: Audio Device Module: An error occurs in using the Java resources.

1007: Audio Device Module: An error occurs in setting the sampling frequency.

1008: Audio Device Module: An error occurs in initializing the playback device.

1009: Audio Device Module: An error occurs in starting the playback device.

1010: Audio Device Module: An error occurs in stopping the playback device.

1011: Audio Device Module: An error occurs in initializing the recording device.

1012: Audio Device Module: An error occurs in starting the recording device.

1013: Audio Device Module: An error occurs in stopping the recording device.

1015: Audio Device Module: A playback error occurs. Check your playback device and try rejoining the channel.

1017: Audio Device Module: A recording error occurs.

1018: Audio Device Module: Fails to record.

1022: Audio Device Module: An error occurs in initializing the loopback device.

1023: Audio Device Module: An error occurs in starting the loopback device.

1027: Audio Device Module: No recording permission exists. Check if the recording permission is granted.

1033: Audio device module: The device is occupied.

1101: Audio device module: A fatal exception occurs.

1108: Audio device module: The recording frequency is lower than 50. 0 indicates that the recording is not yet started. We recommend checking your recording permission.

1109: The playback frequency is lower than 50. 0 indicates that the playback is not yet started. We recommend checking if you have created too many AudioTrack instances.

1111: Audio device module: AudioRecord fails to start up. A ROM system error occurs. We recommend the following options to debug:

• Restart your App.
• Restart your cellphone.
• Check your recording permission.

1112: Audio device module: AudioTrack fails to start up. A ROM system error occurs. We recommend the following options to debug:

• Restart your App.
• Restart your cellphone.
• Check your playback permission.

1115: Audio device module: AudioRecord returns error. The SDK will automatically restart AudioRecord.

DEPRECATED

DEPRECATED

DEPRECATED

DEPRECATED

DEPRECATED

1201: Audio device module: The current device does not support audio input, possibly because you have mistakenly configured the audio session category, or because some other app is occupying the input device. We recommend terminating all background apps and re-joining the channel.

1206: Audio device module: Cannot activate the Audio Session.

1210: Audio device module: Fails to initialize the audio device, normally because the audio device parameters are wrongly set.

1213: Audio device module: Fails to re-initialize the audio device, normally because the audio device parameters are wrongly set.

1214: Fails to re-start up the Audio Unit, possibly because the audio session category is not compatible with the settings of the Audio Unit.

DEPRECATED

1301: Audio device module: An audio driver abnomality or a compatibility issue occurs. Solutions: Disable and restart the audio device, or reboot the system.

1303: Audio device module: A recording driver abnomality or a compatibility issue occurs. Solutions: Disable and restart the audio device, or reboot the system.

1306: Audio device module: A playout driver abnomality or a compatibility issue occurs. Solutions: Disable and restart the audio device, or reboot the system.

1307: Audio device module: No audio device is available. Solutions: Plug in a proper audio device.

1309: Audio device module: An audio driver abnomality or a compatibility issue occurs. Solutions: Disable and restart the audio device, or reboot the system.

1311: Audio device module: Insufficient system memory or poor device performance. Solutions: Reboot the system or replace the device.

1314: Audio device module: An audio driver abnormality occurs. Solutions:

• Disable and then re-enable the audio device.
• Reboot the system.
• Upgrade your audio card driver.

1319: Audio device module: Insufficient system memory or poor device performance. Solutions: Reboot the system or replace the device.

1320: Audio device module: An audio driver abnormality occurs. Solutions:

• Disable and then re-enable the audio device.
• Reboot the system.
• Replace the device.

1322: Audio device module: No audio sampling device is available. Solutions: Plug in a proper recording device.

1323: Audio device module: No audio playout device is available. Solutions: Plug in a proper playback device.

1351: Audio device module: An audio driver abnormality or a compatibility issue occurs. Solutions:

• Disable and then re-enable the audio device.
• Reboot the system.
• Upgrade your audio card driver.

1353: Audio device module: An audio driver abnormality occurs. Solutions:

• Disable and then re-enable the audio device.
• Reboot the system.
• Upgrade your audio card driver.

1354: Audio device module: An audio driver abnormality occurs. Solutions:

• Disable and then re-enable the audio device.
• Reboot the system.
• Upgrade your audio card driver.

1355: Audio device module: An audio driver abnormality occurs. Solutions:

• Disable and then re-enable the audio device.
• Reboot the system.
• Upgrade your audio card driver.

1356: Audio device module: An audio driver abnormality occurs. Solutions:

• Disable and then re-enable the audio device.
• Reboot the system.
• Upgrade your audio card driver.

1357: Audio device module: An audio driver abnormality occurs. Solutions:

• Disable and then re-enable the audio device.
• Reboot the system.
• Upgrade your audio card driver.

1358: Audio device module: An audio driver abnormality occurs. Solutions:

• Disable and then re-enable the audio device.
• Reboot the system.
• Upgrade your audio card driver.

1359: Audio Device Module: No recording device exists.

1360: Audio Device Module: No playback device exists.

1501: Video Device Module: The camera is unauthorized.

DEPRECATED 1502: Video Device Module: The camera in use.

Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY(3) in the onConnectionStateChanged callback instead.

1600: Video Device Module: An unknown error occurs.

1601: Video Device Module: An error occurs in initializing the video encoder.

1602: Video Device Module: An error occurs in encoding.

1603: Video Device Module: An error occurs in setting the video encoder.

0: Do not output any log information.

0x080f: Output all log information. Set your log filter as debug if you want to get the most complete log file.

0x000f: Output CRITICAL, ERROR, WARNING, and INFO level log information. We recommend setting your log filter as this level.

0x000e: Outputs CRITICAL, ERROR, and WARNING level log information.

0x000c: Outputs CRITICAL and ERROR level log information.

0x0008: Outputs CRITICAL level log information.