0: The quality is unknown.

1: The quality is excellent.

2: The quality is quite good, but the bitrate may be slightly lower than excellent.

3: Users can feel the communication slightly impaired.

4: Users can communicate not very smoothly.

5: The quality is so bad that users can barely communicate.

6: The network is disconnected and users cannot communicate at all.

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

16: Fails 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.

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

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 user role in the Live-broadcast profile.

119: The user role is unauthorized.

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. This warning does not affect communications.

1031: Audio Device Module: The recorded audio volume is too low.

1032: Audio Device Module: The playback audio volume is too low.

1033: Audio Device Module: The recording device is busy.

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.

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. Agora recommends the following methods to solve this error:

• Check the audio device.
• Check the completeness of the app.
• Re-initialize the SDK.

4: The SDK does not support this function.

5: The request is rejected. This is for internal SDK use only, and is not returned to the app through any API method or callback.

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. This is for internal SDK use only, and is not returned to the app through any API method or callback.

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

11: The request is canceled. This is for internal SDK use only, and is not returned to the app through any API method or callback.

12: This method is called too often. This is for internal SDK use only, and is not returned to the app through any API method or callback.

13: The SDK fails to bind to the network socket. This is for internal SDK use only, and is not returned to the app through any API method or callback.

14: The network is unavailable. This is for internal SDK use only, and is not returned to the app through any API method or callback.

15: No network buffers are available. This is for internal SDK use only, and is not returned to the app through any API 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 joinChannel method to join the channel.

18: The request to leave the channel is rejected. This error usually occurs:

• When the user has left the channel and still calls the leaveChannel method to leave the channel. This error stops once the user stops calling this method.
• When the user calls the leaveChannel method before joining a channel. No extra operation is needed.

19: The resources are occupied and cannot be reused.

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.

109: 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 will no longer be 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 Dynamic Key will expire, but that the user will be banned from the channel.</il>

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

• The App Certificate for the project is enabled in Dashboard, 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 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 five streams) are created when the user calls the createDataStream method.

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).

1001: Fails to load the media engine.

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

1003: Fails to start the camera.

1004: Fails to start the video rendering module.

1005: Audio Device Module: A general error occurs in the Audio Device Module (no classified 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 or 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.

1030: Audio Routing: Fails to route the audio to the connected Bluetooth device. The default route is used.

1359: Audio Device Module: No recording device exists.

1360: Audio Device Module: No playback device exists.

1501: Video Device Module: The camera is unauthorized.

1600: Video Device Module: Unknown error.

1601: Video Device Module: Error in initializing the video encoder. This is a serious error and you can try to rejoin the channel.

1602: Video Device Module: Error in the video encoder. This is a serious error and you can try to rejoin the channel.

Deprecated:

This error code is deprecated. 1603: Video Device Module: Error in setting the video encoder.

Deprecated:

0: Resolution: 160 × 120; Frame rate: 15 fps; Bitrate: 65 Kbps

Deprecated:

2: Resolution: 120 × 120; Frame rate: 15 fps; Bitrate 50 Kbps

Deprecated:

10: Resolution: 320 × 180; Frame rate: 15 fps; Bitrate: 140 Kbps

Deprecated:

12: Resolution: 180 × 180; Frame rate: 15 fps; Bitrate: 100 Kbps

Deprecated:

13: Resolution: 240 × 180; Frame rate: 15 fps; Bitrate: 120 Kbps

Deprecated:

20: Resolution: 320 × 240; Frame rate: 15 fps; Bitrate: 200 Kbps

Deprecated:

22: Resolution: 240 × 240; Frame rate: 15 fps; Bitrate: 140 Kbps

Deprecated:

23: Resolution: 424 × 240; Frame rate: 15 fps; Bitrate: 220 Kbps

Deprecated:

30: Resolution: 640 × 360; Frame rate: 15 fps; Bitrate: 400 Kbps

Deprecated:

32: Resolution: 360 × 360; Frame rate: 15 fps; Bitrate: 260 Kbps

Deprecated:

33: Resolution: 640 × 360; Frame rate: 30 fps; Bitrate: 600 Kbps

Deprecated:

35: Resolution: 360 × 360; Frame rate: 30 fps; Bitrate: 400 Kbps

Deprecated:

36: Resolution: 480 × 360; Frame rate: 15 fps; Bitrate: 320 Kbps

Deprecated:

37: Resolution: 480 × 360; Frame rate: 30 fps; Bitrate: 490 Kbps

Deprecated:

38: Resolution: 640 × 360; Frame rate: 15 fps; Bitrate: 800 Kbps

Note

This profile applies to the Live-broadcast channel profile only.

Deprecated:

39: Resolution: 640 × 360; Frame rate: 24 fps; Bitrate: 800 Kbps

Note

This profile applies to the Live-broadcast channel profile only.

Deprecated:

100: Resolution: 640 × 360; Frame rate: 24 fps; Bitrate: 1000 Kbps

Note

This profile applies to the Live-broadcast channel profile only.

Deprecated:

40: Resolution: 640 × 480; Frame rate: 15 fps; Bitrate: 500 Kbps

Deprecated:

42: Resolution: 480 × 480; Frame rate: 15 fps; Bitrate: 400 Kbps

Deprecated:

43: Resolution: 640 × 480; Frame rate: 30 fps; Bitrate: 750 Kbps

Deprecated:

45: Resolution: 480 × 480; Frame rate: 30 fps; Bitrate: 600 Kbps

Deprecated:

47: Resolution: 848 × 480; Frame rate: 15 fps; Bitrate: 610 Kbps

Deprecated:

48: Resolution: 848 × 480; Frame rate: 30 fps; Bitrate: 930 Kbps

Deprecated:

49: Resolution: 640 × 480; Frame rate: 10 fps; Bitrate: 400 Kbps

Deprecated:

50: Resolution: 1280 × 720; Frame rate: 15 fps; Bitrate: 1130 Kbps

Deprecated:

52: Resolution: 1280 × 720; Frame rate: 30 fps; Bitrate: 1710 Kbps

Deprecated:

54: Resolution: 960 × 720; Frame rate: 15 fps; Bitrate: 910 Kbps

Deprecated:

55: Resolution: 960 × 720; Frame rate: 30 fps; Bitrate: 1380 Kbps

Deprecated:

60: Resolution: 1920 × 1080; Frame rate: 15 fps; Bitrate: 2080 Kbps

Deprecated:

62: Resolution: 1920 × 1080; Frame rate: 30 fps; Bitrate: 3150 Kbps

Deprecated:

64: Resolution: 1920 × 1080; Frame rate: 60 fps; Bitrate: 4780 Kbps

Deprecated:

66: Resolution: 2560 × 1440; Frame rate: 30 fps; Bitrate: 4850 Kbps

Deprecated:

67: Resolution: 2560 × 1440; Frame rate: 60 fps; Bitrate: 7350 Kbps

Deprecated:

70: Resolution: 3840 × 2160; Frame rate: 30 fps; Bitrate: 8910 Kbps

Deprecated:

72: Resolution: 3840 × 2160; Frame rate: 60 fps; Bitrate: 13500 Kbps

Deprecated:

Default video profile: Resolution: 640 × 360; Frame rate: 15 fps; Bitrate: 400 Kbps

0: Default audio profile.

In the Communication profile, the default audio profile is SPEECH STANDARD =1. In the Live-broadcast profile, the default audio profile is MUSIC STANDARD = 2.

1: Sampling rate of 32 kHz, audio encoding, mono, and a bitrate of up to 18 Kbps.

2: Sampling rate of 48 kHz, music encoding, mono, and a bitrate of up to 48 Kbps.

3: Sampling rate of 48 kHz, music encoding, stereo, and a bitrate of up to 56 Kbps.

4: Sampling rate of 48 kHz, music encoding, mono, and a bitrate of up to 128 Kbps.

5: Sampling rate of 48 kHz, music encoding, stereo, and a bitrate of up to 192 Kbps.

0: Default audio application scenario.

1: Entertainment scenario supporting voice during gameplay.

2: Education scenario prioritizing fluency and stability.

3: Live gaming scenario enabling the gaming audio effects in the speaker mode in a live broadcast scenario.

4: Showroom scenario optimizing the audio quality with professional external equipment.

5: Gaming scenario.

0: 31 Hz

1: 62 Hz

2: 125 Hz

3: 250 Hz

4: 500 Hz

5: 1 kHz

6: 2 kHz

7: 4 kHz

8: 8 kHz

9: 16 kHz

0: Level of the dry signal (-20 to 10 dB).

1: Level of the early reflection signal (wet signal) (-20 to 10 dB).

2: Room size of the reflection (0 to 100 dB).

3: Length of the initial delay of the wet signal (0 to 200 ms).

4: Strength of the late reverberation (0 to 100).

0: The channel profile is Communication.

This is used in one-on-one calls or group calls, where all users in the channel can talk freely.

1: The channel profile is Live Broadcast.

Host and audience roles that can be set by calling the setClientRole method. The host sends and receives voice/video, while the audience only receives voice/video.

2: The channel profile is Gaming.

Any user in the channel can talk freely. This mode uses the codec with low-power consumption and low bitrate by default.

Note

This profile applies to the Agora Gaming SDK only.

1: The host in a live broadcast.

2: The audience in a live broadcast.

0: The user quits the call.

1: The SDK timed out and the user dropped offline because it has not received any data packet for a period of time. If a user quits the call and the message is not passed to the SDK (due to an unreliable channel), the SDK assumes the user has dropped offline.

2: The client role switches from a host to an audience.

0: The external video stream imports successfully.

1: The external video stream already exists.

2: The external video stream import is unauthorized.

3: An import external video stream timeout.

4: The external video stream fails to import.

5: The external video stream stops importing successfully.

6: No external video stream is found.

7: The external video stream to be stopped importing is unauthorized.

8: Stop importing external video stream timeout.

9: Stop importing external video stream failed.

10: The external video stream is corrupted.

0: The quality report is in JSON format.

1: The quality report is in HTML format.

1: Uniformly scale the video until it fills the visible boundaries (cropped). One dimension of the video may have clipped contents.

2: Uniformly scale the video until one of its dimension fits the boundary (zoomed to fit). Areas that are not filled due to the disparity in the aspect ratio are filled with black.

Deprecated:

3: Adaptive mode: If both callers use the same screen orientation, such as both use vertical screens or both use horizontal screens, the RENDER_MODE_HIDDEN mode applies; if they use different screen orientations, such as one vertical and one horizontal, the RENDER_MODE_FIT mode applies.

0: The default mirror mode (the mode set by the SDK).

1: Enable the mirror mode.

2: Disable the mirror mode

0: Do not output any log.

0x80f: Output all API logs.

0x0f: Output logs of the CRITICAL, ERROR, WARNING, and INFO level.

0x0e: Output logs of the CRITICAL, ERROR, and WARNING level.

0x0c: Output logs of the CRITICAL and ERROR level.

0x08: Output logs of the CRITICAL level.

-1: Default audio route.

0: Headset.

1: Earpiece.

2: Headset with no microphone.

3: Speakerphone.

4: Loudspeaker.

5: Bluetooth headset.

0: High-stream (high-resolution, high-bitrate) video.

1: Low-stream (low-resolution, low-bitrate) video.

0: Hardware encoder.

1: Software encoder.

0: Read-only mode. Users only read the Agora Audio Frame data without modifying anything. For example, when users acquire data with the Agora SDK and push RTMP streams by themselves.

1: Write-only mode. Users replace the Agora Audio Frame data with their own data and pass it to the SDK for encoding. For example, when users acquire data by themselves.

2: Read and write mode. Users read the data from the Agora Audio Frame, modify it and then play it. For example, when users have their own sound-effect processing module and want to do voice pre-processing, such as a voice change.

1: The SDK is disconnected from Agora's edge server.

• This is the initial state before calling the joinChannel method.
• The SDK also enters this state when the app calls the leaveChannel method.

2: The SDK is connecting to Agora's edge server.

• When the app calls the joinChannel method, the SDK starts to establish a connection to the specified channel, triggers the onConnectionStateChanged callback, and switches to the CONNECTION_STATE_CONNECTING state.
• When a user successfully joins a channel, the SDK triggers the onConnectionStateChanged callback and switches to the CONNECTION_STATE_CONNECTED state.
• After the SDK joins the channel and when it finishes initializing the media engine, the SDK triggers the onJoinChannelSuccess callback.

3: The SDK is connected to Agora's edge server and has joined a channel. You can now publish or subscribe to a media stream in the channel. If the connection to the channel is lost because, for example, the network is down or switched, the SDK triggers:

• The onConnectionInterrupted (deprecated) callback.
• The onConnectionStateChanged callback, and switches to the CONNECTION_STATE_RECONNECTING state.

4: The SDK keeps rejoining the channel after being disconnected from a joined channel because of network issues.

• If the SDK cannot join the channel within 10 seconds after being disconnected from Agora's edge server, the SDK triggers the onConnectionLost (deprecated) callback, stays in the CONNECTION_STATE_RECONNECTING state, and keeps rejoining the channel.
• If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK triggers the onConnectionStateChanged callback, switches to the CONNECTION_STATE_FAILED state, and keeps rejoining the channel.

5: The SDK fails to connect to Agora's edge server or join the channel. You must call the leaveChannel method to leave this state and call the joinChannel method again to rejoin the channel. If the SDK is banned from joining the channel by the Agora server (through the RESTful API), the SDK triggers the onConnectionBanned and onConnectionStateChanged callbacks.

0: The SDK is connecting to Agora's edge server.

1: The SDK has joined the channel successfully.

2: The connection between the SDK and Agora's edge server is interrupted.

3: The connection between the SDK and Agora's edge server is banned by Agora's edge server.

4: The SDK fails to join the channel for more than 20 minutes and stops reconnecting to the channel.

5: The SDK has left the channel.

Deprecated:

1: Binds the RTMP stream lifecycle to the channel lifecycle. If all hosts leave the channel, CDN live streaming stops after 30 seconds.

Deprecated:

2: Binds the RTMP stream lifecycle to the owner of the RTMP stream. If the owner leaves the channel, CDN live streaming stops immediately.

0: Low quality. The file size is around 1.2 MB after 10 minutes of recording.

1: Medium quality. The file size is around 2 MB after 10 minutes of recording.

2: High quality. The file size is around 3.75 MB after 10 minutes of recording.

0: None.

1: Audio only.

2: Video only.

3: Audio and video.

0: No fallback behavior for the local/remote streams when the uplink/downlink network condition is poor. The quality of the stream is not guaranteed.

1: Under poor downlink network conditions, the remotely subscribed stream falls back to the low-stream (low-resolution and low-bitrate) video. You can only set this option in the setRemoteSubscribeFallbackOption method. Nothing happens when you set this in the setLocalPublishFallbackOption method.

2:

• Under poor uplink network conditions, the locally published stream falls back audio only.
• Under poor downlink network conditions, the remotely subscribed stream first falls back to the low-stream (low-resolution and low-bitrate) video; and then to an audio-only stream if the network condition deteriorates.