Type definition

Enumerator

MainProcess

Use the main process to create IAgoraRtcEngine, which can be used to send the camera-captured video stream.

SubProcess

Use the sub process to create IAgoraRtcEngine, which can be used to send the screen-captured video stream.

Enumerator

AREA_CODE_CN

Mainland China.

AREA_CODE_NA

North America.

AREA_CODE_EU

Europe.

AREA_CODE_AS

Asia, excluding Mainland China.

AREA_CODE_JP

Japan.

AREA_CODE_IN

India.

AREA_CODE_GLOB

(Default) Global.

Enumerator

AUDIENCE_LATENCY_LEVEL_LOW_LATENCY

1: Low latency.

AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY

2: (Default) Ultra low latency.

Enumerator

AUDIO_CODEC_PROFILE_LC_AAC

0: (Default) LC-AAC.

AUDIO_CODEC_PROFILE_HE_AAC

1: HE-AAC.

AUDIO_CODEC_PROFILE_HE_AAC_V2

2: HE-AAC v2.

Enumerator

AudioTestRecordingVolume

0: The volume of the audio capturing device.

AudioTestPlaybackVolume

1: The volume of the audio playback device.

For better voice effects, Agora recommends setting the profile parameter of SetAudioProfile to AUDIO_PROFILE_MUSIC_HIGH_QUALITY or AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO before using the following presets:

• ROOM_ACOUSTICS_KTV
• ROOM_ACOUSTICS_VOCAL_CONCERT
• ROOM_ACOUSTICS_STUDIO
• ROOM_ACOUSTICS_PHONOGRAPH
• ROOM_ACOUSTICS_SPACIAL
• ROOM_ACOUSTICS_ETHEREAL
• VOICE_CHANGER_EFFECT_UNCLE
• VOICE_CHANGER_EFFECT_OLDMAN
• VOICE_CHANGER_EFFECT_BOY
• VOICE_CHANGER_EFFECT_SISTER
• VOICE_CHANGER_EFFECT_GIRL
• VOICE_CHANGER_EFFECT_PIGKING
• VOICE_CHANGER_EFFECT_HULK
• PITCH_CORRECTION

Enumerator

AUDIO_EFFECT_OFF

Turn off voice effects, that is, use the original voice.

ROOM_ACOUSTICS_KTV

The voice effect typical of a KTV venue.

ROOM_ACOUSTICS_VOCAL_CONCERT

The voice effect typical of a concert hall.

ROOM_ACOUSTICS_STUDIO

The voice effect typical of a recording studio.

ROOM_ACOUSTICS_PHONOGRAPH

The voice effect typical of a vintage phonograph.

ROOM_ACOUSTICS_VIRTUAL_STEREO

The virtual stereo effect, which renders monophonic audio as stereo audio.

Attention: Before using this preset, set the profile parameter of SetAudioProfile to AUDIO_PROFILE_MUSIC_HIGH_QUALITY or AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO; otherwise, the preset setting is invalid.

ROOM_ACOUSTICS_SPACIAL

A more spatial voice effect.

ROOM_ACOUSTICS_ETHEREAL

A more ethereal voice effect.

ROOM_ACOUSTICS_3D_VOICE

A 3D voice effect that makes the voice appear to be moving around the user. The default movement cycle is 10 seconds. After setting this effect, you can call SetAudioEffectParameters to modify the movement period.

Attention:

• Before using this preset, set the profile parameter of SetAudioProfile to AUDIO_PROFILE_MUSIC_STANDARD_STEREO or AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO; otherwise, the preset setting is invalid.
• If the 3D voice effect is enabled, users need to use stereo audio playback devices to hear the anticipated voice effect.

VOICE_CHANGER_EFFECT_UNCLE

A middle-aged man's voice.

Attention: Agora recommends using this preset to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect.

VOICE_CHANGER_EFFECT_OLDMAN

A senior man's voice.

Attention: Agora recommends using this preset to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect.

VOICE_CHANGER_EFFECT_BOY

A boy's voice.

Attention: Agora recommends using this preset to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect.

VOICE_CHANGER_EFFECT_SISTER

A young woman's voice.

Attention: Agora recommends using this preset to process a female-sounding voice; otherwise, you may not hear the anticipated voice effect.

VOICE_CHANGER_EFFECT_GIRL

A girl's voice.

Attention: Agora recommends using this preset to process a female-sounding voice; otherwise, you may not hear the anticipated voice effect.

VOICE_CHANGER_EFFECT_PIGKING

The voice of Pig King, a character in Journey to the West who has a voice like a growling bear.

VOICE_CHANGER_EFFECT_HULK

The Hulk's voice.

STYLE_TRANSFORMATION_RNB

The voice effect typical of R&B music.

Attention: Before using this preset, set the profile parameter of SetAudioProfile to AUDIO_PROFILE_MUSIC_HIGH_QUALITY or AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO; otherwise, the preset setting is invalid.

STYLE_TRANSFORMATION_POPULAR

The voice effect typical of popular music.

Attention: Before using this preset, set the profile parameter of SetAudioProfile to AUDIO_PROFILE_MUSIC_HIGH_QUALITY or AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO; otherwise, the preset setting is invalid.

PITCH_CORRECTION

A pitch correction effect that corrects the user's pitch based on the pitch of the natural C major scale. After setting this voice effect, you can call SetAudioEffectParameters to adjust the basic mode of tuning and the pitch of the main tone.

Enumerator

AUDIO_EQUALIZATION_BAND_31

0: 31 Hz

AUDIO_EQUALIZATION_BAND_62

1: 62 Hz

AUDIO_EQUALIZATION_BAND_125

2: 125 Hz

AUDIO_EQUALIZATION_BAND_250

3: 250 Hz

AUDIO_EQUALIZATION_BAND_500

4: 500 Hz

AUDIO_EQUALIZATION_BAND_1K

5: 1 kHz

AUDIO_EQUALIZATION_BAND_2K

6: 2 kHz

AUDIO_EQUALIZATION_BAND_4K

7: 4 kHz

AUDIO_EQUALIZATION_BAND_8K

8: 8 kHz

AUDIO_EQUALIZATION_BAND_16K

9: 16 kHz

Enumerator

AUDIO_FILE_INFO_ERROR_OK

0: Successfully get the information of an audio file.

AUDIO_FILE_INFO_ERROR_FAILURE

1: Fail to get the information of an audio file.

Enumerator

FRAME_TYPE_PCM16

0: PCM 16

Deprecated:

Deprecated as of v3.4.0.

Enumerator

AUDIO_MIXING_ERROR_CAN_NOT_OPEN

The SDK cannot open the music file.

AUDIO_MIXING_ERROR_TOO_FREQUENT_CALL

The SDK opens the music file too frequently.

AUDIO_MIXING_ERROR_INTERRUPTED_EOF

The playback of the music file is interrupted.

AUDIO_MIXING_ERROR_OK

The music file is playing.

Enumerator

AUDIO_MIXING_REASON_CAN_NOT_OPEN

701: The SDK cannot open the music file. For example, the local music file does not exist, the SDK does not support the file format, or the SDK cannot access the music file URL.

AUDIO_MIXING_REASON_TOO_FREQUENT_CALL

702: The SDK opens the music file too frequently. If you need to call startAudioMixing multiple times, ensure that the call interval is more than 500 ms.

AUDIO_MIXING_REASON_INTERRUPTED_EOF

703: The music file playback is interrupted.

AUDIO_MIXING_REASON_STARTED_BY_USER

720: The method call of startAudioMixing to play music files succeeds.

AUDIO_MIXING_REASON_ONE_LOOP_COMPLETED

721: The music file completes a loop playback.

AUDIO_MIXING_REASON_START_NEW_LOOP

722: The music file starts a new loop playback.

AUDIO_MIXING_REASON_ALL_LOOPS_COMPLETED

723: The music file completes all loop playbacks.

AUDIO_MIXING_REASON_STOPPED_BY_USER

724: The method call of StopAudioMixing to stop playing the music file succeeds.

AUDIO_MIXING_REASON_PAUSED_BY_USER

725: The method call of PauseAudioMixing to pause playing the music file succeeds.

AUDIO_MIXING_REASON_RESUMED_BY_USER

726: The method call of ResumeAudioMixing to resume playing the music file succeeds.

Enumerator

AUDIO_MIXING_STATE_PLAYING

710: The music file is playing.

The possible reasons include:

• AUDIO_MIXING_REASON_STARTED_BY_USER(710)
• AUDIO_MIXING_REASON_ONE_LOOP_COMPLETED(720)
• AUDIO_MIXING_REASON_START_NEW_LOOP(722)
• AUDIO_MIXING_REASON_RESUMED_BY_USER(726)

AUDIO_MIXING_STATE_PAUSED

711: The music file pauses playing.

This state is due toAUDIO_MIXING_REASON_PAUSED_BY_USER (725).

AUDIO_MIXING_STATE_STOPPED

713: The music file stops playing.

The possible reasons include:

• AUDIO_MIXING_REASON_ALL_LOOPS_COMPLETED(723)
• AUDIO_MIXING_REASON_STOPPED_BY_USER(724)

AUDIO_MIXING_STATE_FAILED

714: An error occurs during the playback of the audio mixing file.

The possible reasons include:

• AUDIO_MIXING_REASON_CAN_NOT_OPEN(701)
• AUDIO_MIXING_REASON_TOO_FREQUENT_CALL(702)
• AUDIO_MIXING_REASON_INTERRUPTED_EOF(703)

Enumerator

AUDIO_PROFILE_DEFAULT

0: The default audio profile.

• For the interactive streaming profile: A sample rate of 48 kHz, music encoding, mono, and a bitrate of up to 64 Kbps.
• For the communication profile:

AUDIO_PROFILE_SPEECH_STANDARD

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

AUDIO_PROFILE_MUSIC_STANDARD

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

AUDIO_PROFILE_MUSIC_STANDARD_STEREO

3: A sample rate of 48 kHz, music encoding, stereo, and a bitrate of up to 80 Kbps.

AUDIO_PROFILE_MUSIC_HIGH_QUALITY

4: A sample rate of 48 kHz, music encoding, mono, and a bitrate of up to 96 Kbps.

AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO

5: A sample rate of 48 kHz, music encoding, stereo, and a bitrate of up to 128 Kbps.

AUDIO_PROFILE_IOT

6: A sample rate of 16 kHz, audio encoding, mono, and Acoustic Echo Cancellation (AES) enabled.

AUDIO_PROFILE_NUM

Enumerator boundary.

Enumerator

AUDIO_RECORDING_QUALITY_LOW

0: Low quality. The sample rate is 32 kHz, and the file size is around 1.2 MB after 10 minutes of recording.

AUDIO_RECORDING_QUALITY_MEDIUM

1: Medium quality. The sample rate is 32 kHz, and the file size is around 2 MB after 10 minutes of recording.

AUDIO_RECORDING_QUALITY_HIGH

2: High quality. The sample rate is 32 kHz, and the file size is around 3.75 MB after 10 minutes of recording.

AUDIO_RECORDING_QUALITY_ULTRA_HIGH

3: Ultra high quality. The sample rate is 32 kHz, and the file size is around 7.5 MB after 10 minutes of recording.

Enumerator

AUDIO_REVERB_OFF

Turn off voice reverb, that is, to use the original voice.

AUDIO_REVERB_FX_KTV

The reverb style typical of a KTV venue (enhanced).

AUDIO_REVERB_FX_VOCAL_CONCERT

The reverb style typical of a concert hall (enhanced).

AUDIO_REVERB_FX_UNCLE

A middle-aged man's voice.

AUDIO_REVERB_FX_SISTER

The reverb style typical of a young woman's voice.

AUDIO_REVERB_FX_STUDIO

The reverb style typical of a recording studio (enhanced).

AUDIO_REVERB_FX_POPULAR

The reverb style typical of popular music (enhanced).

AUDIO_REVERB_FX_RNB

The reverb style typical of R&B music (enhanced).

AUDIO_REVERB_FX_PHONOGRAPH

The voice effect typical of a vintage phonograph.

AUDIO_REVERB_POPULAR

The voice effect typical of popular music.

AUDIO_REVERB_RNB

The voice effect typical of R&B music.

AUDIO_REVERB_ROCK

The reverb style typical of rock music.

AUDIO_REVERB_HIPHOP

The reverb style typical of hip-hop music.

AUDIO_REVERB_VOCAL_CONCERT

The voice effect typical of a concert hall.

AUDIO_REVERB_KTV

The voice effect typical of a KTV venue.

AUDIO_REVERB_STUDIO

The voice effect typical of a recording studio.

AUDIO_VIRTUAL_STEREO

The reverberation of the virtual stereo. The virtual stereo is an effect that renders the monophonic audio as the stereo audio, so that all users in the channel can hear the stereo voice effect.

AUDIO_ELECTRONIC_VOICE

A pitch correction effect that corrects the user's pitch based on the pitch of the natural C major scale.

AUDIO_THREEDIM_VOICE

A 3D voice effect that makes the voice appear to be moving around the user.

Enumerator

AUDIO_REVERB_DRY_LEVEL

0: The level of the dry signal (dB). The value is between -20 and 10.

AUDIO_REVERB_WET_LEVEL

1: The level of the early reflection signal (wet signal) (dB). The value is between -20 and 10.

AUDIO_REVERB_ROOM_SIZE

2: The room size of the reflection. The value is between 0 and 100.

AUDIO_REVERB_WET_DELAY

3: The length of the initial delay of the wet signal (ms). The value is between 0 and 200.

AUDIO_REVERB_STRENGTH

4: The reverberation strength. The value is between 0 and 100.

Enumerator

AUDIO_SAMPLE_RATE_32000

32000: 32 kHz

AUDIO_SAMPLE_RATE_44100

44100: 44.1 kHz

AUDIO_SAMPLE_RATE_48000

48000: (Default) 48 kHz

Enumerator

AUDIO_SCENARIO_DEFAULT

0: The default audio scenario.

AUDIO_SCENARIO_CHATROOM_ENTERTAINMENT

1: Entertainment scenario where users need to frequently switch the user role.

AUDIO_SCENARIO_EDUCATION

2: Education scenario where users want smoothness and stability.

AUDIO_SCENARIO_GAME_STREAMING

3: High-quality audio chatroom scenario where hosts mainly play music.

AUDIO_SCENARIO_SHOWROOM

4: Showroom scenario where a single host wants high-quality audio.

AUDIO_SCENARIO_CHATROOM_GAMING

5: Gaming scenario for group chat that only contains the human voice.

AUDIO_SCENARIO_IOT

6: IoT (Internet of Things) scenario where users use IoT devices with low power consumption.

AUDIO_SCENARIO_MEETING

8: Meeting scenario that mainly contains the human voice.

AUDIO_SCENARIO_NUM

The number of elements in the enumeration.

Enumerator

BACKGROUND_COLOR

1: (Default) The background image is a solid color.

BACKGROUND_IMG

The background image is a file in PNG or JPG format.

BACKGROUND_BLUR

The background image is the blurred background.

Enumerator

BLUR_DEGREE_LOW

1: The degree of blurring applied to the custom background image is low. The user can almost see the background clearly.

BLUR_DEGREE_MEDIUM

The degree of blurring applied to the custom background image is medium. It is difficult for the user to recognize details in the background.

BLUR_DEGREE_HIGH

(Default) The degree of blurring applied to the custom background image is high. The user can barely see any distinguishing features in the background.

Enumerator

CAMERA_REAR

The rear camera.

CAMERA_FRONT

The front camera.

Enumerator

CAPTURE_BRIGHTNESS_LEVEL_INVALID

-1: The SDK does not detect the brightness level of the video image. Wait a few seconds to get the brightness level from captureBrightnessLevel in the next callback.

CAPTURE_BRIGHTNESS_LEVEL_NORMAL

0: The brightness level of the video image is normal.

CAPTURE_BRIGHTNESS_LEVEL_BRIGHT

1: The brightness level of the video image is too bright.

CAPTURE_BRIGHTNESS_LEVEL_DARK

2: The brightness level of the video image is too dark.

Enumerator

CAPTURER_OUTPUT_PREFERENCE_AUTO

0: (Default) Automatically adjust the camera capture preference. The SDK adjusts the camera output parameters according to the system performance and network conditions to balance CPU consumption and video preview quality.

CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE

1: Prioritizes the system performance. The SDK chooses the dimension and frame rate of the local camera capture closest to those set by SetVideoEncoderConfiguration. In this case, the local preview quality depends on the encoder.

CAPTURER_OUTPUT_PREFERENCE_PREVIEW

2: Prioritizes the local preview quality. The SDK chooses higher camera output parameters to improve the local video preview quality. This option requires extra CPU and RAM usage for video pre-processing.

CAPTURER_OUTPUT_PREFERENCE_MANUAL

3: Allows you to customize the width and height of the video image captured by the local camera.

Enumerator

RELAY_OK

0: No error.

RELAY_ERROR_SERVER_ERROR_RESPONSE

1: An error occurs in the server response.

RELAY_ERROR_SERVER_NO_RESPONSE

2: No server response.

You can call LeaveChannel to leave the channel.

This error can also occur if your project has not enabled co-host token authentication. You can support@agora.io to enable the co-host token authentication service before starting a channel media relay.

RELAY_ERROR_NO_RESOURCE_AVAILABLE

3: The SDK fails to access the service, probably due to limited resources of the server.

RELAY_ERROR_FAILED_JOIN_SRC

4: Fails to send the relay request.

RELAY_ERROR_FAILED_JOIN_DEST

5: Fails to accept the relay request.

RELAY_ERROR_FAILED_PACKET_RECEIVED_FROM_SRC

6: The server fails to receive the media stream.

RELAY_ERROR_FAILED_PACKET_SENT_TO_DEST

7: The server fails to send the media stream.

RELAY_ERROR_SERVER_CONNECTION_LOST

8: The SDK disconnects from the server due to poor network connections. You can call the LeaveChannel method to leave the channel.

RELAY_ERROR_INTERNAL_ERROR

9: An internal error occurs in the server.

RELAY_ERROR_SRC_TOKEN_EXPIRED

10: The token of the source channel has expired.

RELAY_ERROR_DEST_TOKEN_EXPIRED

11: The token of the destination channel has expired.

Enumerator

RELAY_EVENT_NETWORK_DISCONNECTED

0: The user disconnects from the server due to a poor network connection.

RELAY_EVENT_NETWORK_CONNECTED

1: The user is connected to the server.

RELAY_EVENT_PACKET_JOINED_SRC_CHANNEL

2: The user joins the source channel.

RELAY_EVENT_PACKET_JOINED_DEST_CHANNEL

3: The user joins the destination channel.

RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL

4: The SDK starts relaying the media stream to the destination channel.

RELAY_EVENT_PACKET_RECEIVED_VIDEO_FROM_SRC

5: The server receives the audio stream from the source channel.

RELAY_EVENT_PACKET_RECEIVED_AUDIO_FROM_SRC

6: The server receives the audio stream from the source channel.

RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL

7: The destination channel is updated.

RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL_REFUSED

8: The destination channel update fails due to internal reasons.

RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL_NOT_CHANGE

9: The destination channel does not change, which means that the destination channel fails to be updated.

RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL_IS_NULL

10: The destination channel name is NULL.

RELAY_EVENT_VIDEO_PROFILE_UPDATE

11: The video profile is sent to the server.

RELAY_EVENT_PAUSE_SEND_PACKET_TO_DEST_CHANNEL_SUCCESS

12: The SDK successfully pauses relaying the media stream to destination channels.

RELAY_EVENT_PAUSE_SEND_PACKET_TO_DEST_CHANNEL_FAILED

13: The SDK fails to pause relaying the media stream to destination channels.

RELAY_EVENT_RESUME_SEND_PACKET_TO_DEST_CHANNEL_SUCCESS

14: The SDK successfully resumes relaying the media stream to destination channels.

RELAY_EVENT_RESUME_SEND_PACKET_TO_DEST_CHANNEL_FAILED

15: The SDK fails to resume relaying the media stream to destination channels.

Enumerator

RELAY_STATE_IDLE

0: The initial state. After you successfully stop the channel media relay by calling StopChannelMediaRelay, the OnChannelMediaRelayStateChanged callback returns this state.

RELAY_STATE_CONNECTING

1: The SDK tries to relay the media stream to the destination channel.

RELAY_STATE_RUNNING

2: The SDK successfully relays the media stream to the destination channel.

RELAY_STATE_FAILURE

3: An error occurs. See code in OnChannelMediaRelayStateChanged for the error code.

Enumerator

CHANNEL_PROFILE_COMMUNICATION

0: (Default) The communication profile. This profile applies to scenarios such as an audio call or video call, where all users can publish and subscribe to streams.

CHANNEL_PROFILE_LIVE_BROADCASTING

1: Live streaming. In this profile, you can set the role of users as the host or audience by calling SetClientRole [2/2]. A host both publishes and subscribes to streams, while an audience subscribes to streams only. This profile applies to scenarios such as a chat room or interactive video streaming.

CHANNEL_PROFILE_GAME

2: Gaming. Agora does not recommend using this setting.

Enumerator

CLIENT_ROLE_BROADCASTER

1: Host. A host can both send and receive streams.

CLIENT_ROLE_AUDIENCE

2: (Default) Audience. An audience member can only receive streams.

Enumerator

NONE_PROXY

0: The automatic mode. In this mode, the SDK attempts a direct connection to SD-RTN™ and automatically switches to TCP/TLS 443 if the attempt fails. As of v3.6.2, the SDK has this mode enabled by default.

UDP_PROXY

1: The cloud proxy for the UDP protocol, that is, the Force UDP cloud proxy mode. In this mode, the SDK always transmits data over UDP.

TCP_PROXY

2: The cloud proxy for the TCP (encryption) protocol, that is, the Force TCP cloud proxy mode. In this mode, the SDK always transmits data over TCP/TLS 443.

Enumerator

NONE_PROXY_TYPE

0: Reserved for future use.

UDP_PROXY_TYPE

1: The cloud proxy for the UDP protocol, that is, the Force UDP cloud proxy mode. In this mode, the SDK always transmits data over UDP.

TCP_PROXY_TYPE

2: The cloud proxy for the TCP (encryption) protocol, that is, the Force TCP cloud proxy mode. In this mode, the SDK always transmits data over TLS 443.

LOCAL_PROXY_TYPE

3: Reserved for future use.

TCP_PROXY_AUTO_FALLBACK_TYPE

4: The automatic mode. In this mode, the SDK attempts a direct connection to SD-RTN™ and automatically switches to TLS 443 if the attempt fails.

Enumerator

CONNECTION_CHANGED_CONNECTING

0: The SDK is connecting to the Agora edge server.

CONNECTION_CHANGED_JOIN_SUCCESS

1: The SDK has joined the channel successfully.

CONNECTION_CHANGED_INTERRUPTED

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

CONNECTION_CHANGED_BANNED_BY_SERVER

3: The connection between the SDK and the Agora edge server is banned by the Agora edge server. This error occurs when the user is kicked out of the channel by the server.

CONNECTION_CHANGED_JOIN_FAILED

4: The SDK fails to join the channel. When the SDK fails to join the channel for more than 20 minutes, this error occurs and the SDK stops reconnecting to the channel.

CONNECTION_CHANGED_LEAVE_CHANNEL

5: The SDK has left the channel.

CONNECTION_CHANGED_INVALID_APP_ID

6: The connection failed because the App ID is not valid. Please rejoin the channel with a valid App ID.

CONNECTION_CHANGED_INVALID_CHANNEL_NAME

7: The connection failed since channel name is not valid. Please rejoin the channel with a valid channel name.

CONNECTION_CHANGED_INVALID_TOKEN

8: The connection failed because the token is not valid. Typical reasons include:

• The App Certificate for the project is enabled in Agora Console, but you do not use a token when joining the channel. If you enable the App Certificate, you must use a token to join the channel.
• The uid specified when calling JoinChannel [2/2] to join the channel is inconsistent with the uid passed in when generating the token.

CONNECTION_CHANGED_TOKEN_EXPIRED

9: The connection failed since token is expired.

CONNECTION_CHANGED_REJECTED_BY_SERVER

10: The connection is rejected by server. Typical reasons include:

• The user is already in the channel and still calls a method, for example, JoinChannel [2/2], to join the channel. Stop calling this method to clear this error.
• The user tries to join the channel when conducting a pre-call test. The user needs to call the channel after the call test ends.

CONNECTION_CHANGED_SETTING_PROXY_SERVER

11: The connection state changed to reconnecting because the SDK has set a proxy server.

CONNECTION_CHANGED_RENEW_TOKEN

12: The connection state changed because the token is renewed.

CONNECTION_CHANGED_CLIENT_IP_ADDRESS_CHANGED

13: The IP address of the client has changed, possibly because the network type, IP address, or port has been changed.

CONNECTION_CHANGED_KEEP_ALIVE_TIMEOUT

14: Timeout for the keep-alive of the connection between the SDK and the Agora edge server. The connection state changes to CONNECTION_STATE_RECONNECTING.

Enumerator

CONNECTION_STATE_DISCONNECTED

1: The SDK is disconnected from the Agora edge server. The state indicates the SDK is in one of the following phases:

• The initial state before calling the JoinChannel [2/2] method.
• The app calls the LeaveChannel method.

CONNECTION_STATE_CONNECTING

2: The SDK is connecting to the Agora edge server. This state indicates that the SDK is establishing a connection with the specified channel after the app calls JoinChannel [2/2].

• If the SDK successfully joins the channel, it triggers the OnConnectionStateChanged callback and the connection state switches to CONNECTION_STATE_CONNECTED.
• After the connection is established, the SDK also initializes the media and triggers OnJoinChannelSuccess when everything is ready.

CONNECTION_STATE_CONNECTED

3: The SDK is connected to the Agora edge server. This state also indicates that the user has joined a channel and can now publish or subscribe to a media stream in the channel. If the connection to the Agora edge server is lost because, for example, the network is down or switched, the SDK automatically tries to reconnect and triggers OnConnectionStateChanged that indicates the connection state switches to CONNECTION_STATE_RECONNECTING.

CONNECTION_STATE_RECONNECTING

4: The SDK keeps reconnecting to the Agora edge server. The SDK keeps rejoining the channel after being disconnected from a joined channel because of network issues.

• If the SDK cannot rejoin the channel within 10 seconds, it triggers OnConnectionLost, 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 the Agora edge server, the SDK triggers the OnConnectionStateChanged callback, switches to the CONNECTION_STATE_FAILED state, and stops rejoining the channel.

CONNECTION_STATE_FAILED

5: The SDK fails to connect to the Agora edge server or join the channel. This state indicates that the SDK stops trying to rejoin the channel. You must call LeaveChannel to leave the channel.

• You can call JoinChannel [2/2] to rejoin the channel.
• If the SDK is banned from joining the channel by the Agora edge server through the RESTful API, the SDK triggers the OnConnectionStateChanged callback.

Enumerator

MAINTAIN_QUALITY

0: (Default) Prefers to reduce the video frame rate while maintaining video quality during video encoding under limited bandwidth. This degradation preference is suitable for scenarios where video quality is prioritized.

Attention: In the COMMUNICATION channel profile, the resolution of the video sent may change, so remote users need to handle this issue. See OnVideoSizeChanged.

MAINTAIN_FRAMERATE

1: Prefers to reduce the video quality while maintaining the video frame rate during video encoding under limited bandwidth. This degradation preference is suitable for scenarios where smoothness is prioritized and video quality is allowed to be reduced.

MAINTAIN_BALANCED

2: Reduces the video frame rate and video quality simultaneously during video encoding under limited bandwidth. MAINTAIN_BALANCED has a lower reduction than MAINTAIN_QUALITY and MAINTAIN_FRAMERATE, and this preference is suitable for scenarios where both smoothness and video quality are a priority.

Attention: The resolution of the video sent may change, so remote users need to handle this issue. See OnVideoSizeChanged.

Agora recommends using AES_128_GCM2 or AES_256_GCM2 encrypted mode. These two modes support the use of salt for higher security.

Enumerator

AES_128_XTS

1: (Default) 128-bit AES encryption, XTS mode.

AES_128_ECB

2: 128-bit AES encryption, ECB mode.

AES_256_XTS

3: 256-bit AES encryption, XTS mode.

SM4_128_ECB

4: 128-bit SM4 encryption, ECB mode.

AES_128_GCM

5: 128-bit AES encryption, GCM mode.

AES_256_GCM

6: 256-bit AES encryption, GCM mode.

AES_128_GCM2

7: 128-bit AES encryption, GCM mode. This encryption mode requires the setting of salt (encryptionKdfSalt).

AES_256_GCM2

8: 256-bit AES encryption, GCM mode. This encryption mode requires the setting of salt (encryptionKdfSalt).

MODE_END

Enumerator boundary.

Enumerator

EXCLUDE_WINDOW_FAIL

-1: Fails to block the window during screen sharing. The user's graphics card does not support window blocking.

EXCLUDE_WINDOW_NONE

0: Reserved.

Enumerator

EXPERIENCE_REASON_NONE

0: No reason, indicating a good QoE of the local user.

REMOTE_NETWORK_QUALITY_POOR

1: The remote user's network quality is poor.

LOCAL_NETWORK_QUALITY_POOR

2: The local user's network quality is poor.

WIRELESS_SIGNAL_POOR

4: The local user's Wi-Fi or mobile network signal is weak.

WIFI_BLUETOOTH_COEXIST

8: The local user enables both Wi-Fi and bluetooth, and their signals interfere with each other. As a result, audio transmission quality is undermined.

Enumerator

EXPERIENCE_QUALITY_GOOD

0: The QoE of the local user is good.

EXPERIENCE_QUALITY_BAD

1: The QoE of the local user is poor.

Enumerator

FRAME_RATE_FPS_1

1: 1 fps

FRAME_RATE_FPS_7

7: 7 fps

FRAME_RATE_FPS_10

10: 10 fps

FRAME_RATE_FPS_15

15: 15 fps

FRAME_RATE_FPS_24

24: 24 fps

FRAME_RATE_FPS_30

30: 30 fps

FRAME_RATE_FPS_60

60: 60 fps

Attention: (For Windows and macOS only)

Enumerator

LASTMILE_PROBE_RESULT_COMPLETE

1: The last-mile network probe test is complete.

LASTMILE_PROBE_RESULT_INCOMPLETE_NO_BWE

2: The last-mile network probe test is incomplete because the bandwidth estimation is not available due to limited test resources.

LASTMILE_PROBE_RESULT_UNAVAILABLE

3: The last-mile network probe test is not carried out, probably due to poor network conditions.

Enumerator

LIGHTENING_CONTRAST_LOW

Low contrast level.

LIGHTENING_CONTRAST_NORMAL

(Default) Normal contrast level.

LIGHTENING_CONTRAST_HIGH

High contrast level.

Enumerator

LOCAL_AUDIO_STREAM_ERROR_OK

0: The local audio is normal.

LOCAL_AUDIO_STREAM_ERROR_FAILURE

1: No specified reason for the local audio failure.

LOCAL_AUDIO_STREAM_ERROR_DEVICE_NO_PERMISSION

2: No permission to use the local audio device.

LOCAL_AUDIO_STREAM_ERROR_DEVICE_BUSY

3: The microphone is in use.

LOCAL_AUDIO_STREAM_ERROR_RECORD_FAILURE

4: The local audio capturing fails. Check whether the capturing device is working properly.

LOCAL_AUDIO_STREAM_ERROR_ENCODE_FAILURE

5: The local audio encoding fails.

LOCAL_AUDIO_STREAM_ERROR_NO_RECORDING_DEVICE

6: No audio recording device.

LOCAL_AUDIO_STREAM_ERROR_NO_PLAYOUT_DEVICE

7: No audio playout device.

LOCAL_AUDIO_STREAM_ERROR_INTERRUPTED

8: The local audio capture is interrupted by a system call. If the local audio capture is required, remind your user to hang up the phone.

LOCAL_AUDIO_STREAM_ERROR_RECORD_INVALID_ID

9: The ID of the local audio-capture device is invalid. Check the audio capture device ID.

LOCAL_AUDIO_STREAM_ERROR_PLAYOUT_INVALID_ID

10: The ID of the local audio-playback device is invalid. Check the audio playback device ID.

Enumerator

LOCAL_AUDIO_STREAM_STATE_STOPPED

0: The local audio is in the initial state.

LOCAL_AUDIO_STREAM_STATE_RECORDING

1: The capturing device starts successfully.

LOCAL_AUDIO_STREAM_STATE_ENCODING

2: The first audio frame encodes successfully.

LOCAL_AUDIO_STREAM_STATE_FAILED

3: The local audio fails to start.

Enumerator

LOCAL_VIDEO_STREAM_ERROR_OK

0: The local video is normal.

LOCAL_VIDEO_STREAM_ERROR_FAILURE

1: No specified reason for the local video failure.

LOCAL_VIDEO_STREAM_ERROR_DEVICE_NO_PERMISSION

2: No permission to use the local video capturing device.

LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY

3: The local video capturing device is in use.

LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE

4: The local video capture fails. Check whether the capturing device is working properly.

LOCAL_VIDEO_STREAM_ERROR_ENCODE_FAILURE

5: The local video encoding fails.

LOCAL_VIDEO_STREAM_ERROR_CAPTURE_INBACKGROUND

6: The local video capturing device not available due to app did enter background.

LOCAL_VIDEO_STREAM_ERROR_CAPTURE_MULTIPLE_FOREGROUND_APPS

7: The local video capturing device not available because the app is running in a multi-app layout (generally on the pad).

LOCAL_VIDEO_STREAM_ERROR_DEVICE_NOT_FOUND

Since

v3.4.0

8: Fails to find a local video capture device.

LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_MINIMIZED

11: When calling StartScreenCaptureByWindowId to share the window, the shared window is in a minimized state.

LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_CLOSED

Since

v3.2.0

12: The error code indicates that a window shared by the window ID has been closed, or a full-screen window shared by the window ID has exited full-screen mode. After exiting full-screen mode, remote users cannot see the shared window. To prevent remote users from seeing a black screen, Agora recommends that you immediately stop screen sharing.

Common scenarios for reporting this error code:

• When the local user closes the shared window, the SDK reports this error code.
• The local user shows some slides in full-screen mode first, and then shares the cpp of the slides. After the user exits full-screen mode, the SDK reports this error code.
• The local user watches web video or reads web document in full-screen mode first, and then shares the window of the web video or document. After the user exits full-screen mode, the SDK reports this error code.

LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_OCCLUDED

13: (Windows only) The window being shared is overlapped by another window, so the overlapped area is blacked out by the SDK during window sharing.

LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_NOT_SUPPORTED

20: (Windows only) The SDK does not support sharing this type of window.

Enumerator

LOCAL_VIDEO_STREAM_STATE_STOPPED

0: The local video is in the initial state.

LOCAL_VIDEO_STREAM_STATE_CAPTURING

1: The local video capturing device starts successfully.

LOCAL_VIDEO_STREAM_STATE_ENCODING

2: The first video frame is successfully encoded.

LOCAL_VIDEO_STREAM_STATE_FAILED

3: Fails to start the local video.

Enumerator

LOG_FILTER_OFF

0: Do not output any log information.

LOG_FILTER_DEBUG

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

LOG_FILTER_INFO

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

LOG_FILTER_WARN

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

LOG_FILTER_ERROR

0x000c: Output CRITICAL and ERROR level log information.

LOG_FILTER_CRITICAL

0x0008: Output CRITICAL level log information.

Enumerator

LOG_LEVEL_NONE

0: Do not output any log information.

LOG_LEVEL_INFO

0x0001: (Default) Output FATAL, ERROR, WARN, and INFO level log information. We recommend setting your log filter as this level.

LOG_LEVEL_WARN

0x0002: Output FATAL, ERROR, and WARN level log information.

LOG_LEVEL_ERROR

0x0004: Output FATAL and ERROR level log information.

LOG_LEVEL_FATAL

0x0008: Output FATAL level log information.

Enumerator

LOW_LIGHT_ENHANCE_LEVEL_HIGH_QUALITY

0: (Default) Promotes video quality during low-light enhancement. It processes the brightness, details, and noise of the video image. The performance consumption is moderate, the processing speed is moderate, and the overall video quality is optimal.

LOW_LIGHT_ENHANCE_LEVEL_FAST

Promotes performance during low-light enhancement. It processes the brightness and details of the video image. The processing speed is faster.

Enumerator

LOW_LIGHT_ENHANCE_AUTO

0: (Default) Automatic mode. The SDK automatically enables or disables the low-light enhancement feature according to the ambient light to compensate for the lighting level or prevent overexposure, as necessary.

LOW_LIGHT_ENHANCE_MANUAL

Manual mode. Users need to enable or disable the low-light enhancement feature manually.

Enumerator

MAX_CHANNEL_ID_LENGTH

The maximum length of the channel name is 64 bytes.

Enumerator

MAX_DEVICE_ID_LENGTH

The maximum length of the device ID is 512 bytes.

Enumerator

MAX_USER_ACCOUNT_LENGTH

The maximum length of the user account is 256 bytes.

Enumerator

MEDIA_DEVICE_STATE_IDLE

0: The device is ready for use.

MEDIA_DEVICE_STATE_ACTIVE

1: The device is in use.

MEDIA_DEVICE_STATE_DISABLED

2: The device is disabled.

MEDIA_DEVICE_STATE_NOT_PRESENT

4: The device is not found.

MEDIA_DEVICE_STATE_UNPLUGGED

8: The device is unplugged.

MEDIA_DEVICE_STATE_UNRECOMMENDED

16: The device is not recommended.

Enumerator

UNKNOWN_AUDIO_DEVICE

-1: Unknown device type.

AUDIO_PLAYOUT_DEVICE

0: Audio playback device.

AUDIO_RECORDING_DEVICE

1: Audio capturing device.

VIDEO_RENDER_DEVICE

2: Video renderer.

VIDEO_CAPTURE_DEVICE

3: Video capturer.

AUDIO_APPLICATION_PLAYOUT_DEVICE

4: Application audio playback device.

Enumerator

AUDIO_PLAYOUT_SOURCE

0: Audio playback device.

AUDIO_RECORDING_SOURCE

1: Audio capturing device.

Enumerator

FORMAT_MP4

1: (Default) MP4.

FORMAT_FLV

Reserved parameter.

Enumerator

STREAM_TYPE_AUDIO

Only audio.

STREAM_TYPE_VIDEO

only video.

STREAM_TYPE_BOTH

(Default) Audio and video.

Enumerator

UNKNOWN_METADATA

The type of metadata is unknown.

VIDEO_METADATA

The type of metadata is video.

Enumerator

NETWORK_TYPE_UNKNOWN

-1: The network type is unknown.

NETWORK_TYPE_DISCONNECTED

0: The SDK disconnects from the network.

NETWORK_TYPE_LAN

1: The network type is LAN.

NETWORK_TYPE_WIFI

2: The network type is Wi-Fi (including hotspots).

NETWORK_TYPE_MOBILE_2G

3: The network type is mobile 2G.

NETWORK_TYPE_MOBILE_3G

4: The network type is mobile 3G.

NETWORK_TYPE_MOBILE_4G

5: The network type is mobile 4G.

NETWORK_TYPE_MOBILE_5G

6: The network type is mobile 5G.

Enumerator

ORIENTATION_MODE_ADAPTIVE

0: (Default) The output video always follows the orientation of the captured video. The receiver takes the rotational information passed on from the video encoder. This mode applies to scenarios where video orientation can be adjusted on the receiver.

• If the captured video is in landscape mode, the output video is in landscape mode.
• If the captured video is in portrait mode, the output video is in portrait mode.

ORIENTATION_FIXED_LANDSCAPE

1: In this mode, the SDK always outputs videos in landscape (horizontal) mode. If the captured video is in portrait mode, the video encoder crops it to fit the output. Applies to situations where the receiving end cannot process the rotational information. For example, CDN live streaming.

ORIENTATION_FIXED_PORTRAIT

2: In this mode, the SDK always outputs video in portrait (portrait) mode. If the captured video is in landscape mode, the video encoder crops it to fit the output. Applies to situations where the receiving end cannot process the rotational information. For example, CDN live streaming.

Enumerator

PRIORITY_HIGH

The user's priority is high.

PRIORITY_NORMAL

(Default) The user's priority is normal.

Enumerator

ADAPT_NONE

0: The local video quality stays the same.

ADAPT_UP_BANDWIDTH

1: The local video quality improves because the network bandwidth increases.

ADAPT_DOWN_BANDWIDTH

2: The local video quality deteriorates because the network bandwidth decreases.

Enumerator

QUALITY_REPORT_JSON

0: The quality report in JSON format.

QUALITY_REPORT_HTML

1: The quality report in HTML format.

Enumerator

QUALITY_UNKNOWN

0: The network quality is unknown.

QUALITY_EXCELLENT

1: The network quality is excellent.

QUALITY_GOOD

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

QUALITY_POOR

3: Users can feel the communication slightly impaired.

QUALITY_BAD

4: Users cannot communicate smoothly.

QUALITY_VBAD

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

QUALITY_DOWN

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

QUALITY_UNSUPPORTED

7: Users cannot detect the network quality. (Not in use.)

QUALITY_DETECTING

8: Detecting the network quality.

Enumerator

RAW_AUDIO_FRAME_OP_MODE_READ_ONLY

0: Read-only mode: For example, when users acquire the data with the Agora SDK, then start the media push.

RAW_AUDIO_FRAME_OP_MODE_WRITE_ONLY

1: Write-only mode: For example, when users acquire the data.

RAW_AUDIO_FRAME_OP_MODE_READ_WRITE

2: Read and write mode: For example, when users have their own audio-effect processing module and perform some voice pre-processing, such as a voice change.

Enumerator

RECORDER_ERROR_NONE

0: No error occurs.

RECORDER_ERROR_WRITE_FAILED

1: The SDK fails to write the recorded data to a file.

RECORDER_ERROR_NO_STREAM

2: The SDK does not detect audio and video streams to be recorded, or audio and video streams are interrupted for more than five seconds during recording.

RECORDER_ERROR_OVER_MAX_DURATION

3: The recording duration exceeds the upper limit.

RECORDER_ERROR_CONFIG_CHANGED

4: The recording configuration changes.

RECORDER_ERROR_CUSTOM_STREAM_DETECTED

5: The SDK detects audio and video streams from users using versions of the SDK earlier than v3.0.0 in the COMMUNICATION channel profile.

Enumerator

RECORDER_STATE_ERROR

-1: An error occurs during the recording. See RecorderErrorCode for the reason.

RECORDER_STATE_START

2: The audio and video recording starts.

RECORDER_STATE_STOP

3: The audio and video recording stops.

Enumerator

REMOTE_AUDIO_STATE_REASON_INTERNAL

0: The SDK reports this reason when the audio state changes.

REMOTE_AUDIO_STATE_REASON_NETWORK_CONGESTION

1: Network congestion.

REMOTE_AUDIO_STATE_REASON_NETWORK_RECOVERY

2: Network recovery.

REMOTE_AUDIO_STATE_REASON_LOCAL_MUTED

3: The local user stops receiving the remote audio stream or disables the audio module.

REMOTE_AUDIO_STATE_REASON_LOCAL_UNMUTED

4: The local user resumes receiving the remote audio stream or enables the audio module.

REMOTE_AUDIO_STATE_REASON_REMOTE_MUTED

5: The remote user stops sending the audio stream or disables the audio module.

REMOTE_AUDIO_STATE_REASON_REMOTE_UNMUTED

6: The remote user resumes sending the audio stream or enables the audio module.

REMOTE_AUDIO_STATE_REASON_REMOTE_OFFLINE

7: The remote user leaves the channel.

Enumerator

REMOTE_AUDIO_STATE_STOPPED

0: The local audio is in the initial state. The SDK reports this state in the case of REMOTE_AUDIO_STATE_REASON_LOCAL_MUTED, REMOTE_AUDIO_STATE_REASON_REMOTE_MUTED or REMOTE_AUDIO_STATE_REASON_REMOTE_OFFLINE.

REMOTE_AUDIO_STATE_STARTING

1: The first remote audio packet is received.

REMOTE_AUDIO_STATE_DECODING

2: The remote audio stream is decoded and plays normally. The SDK reports this state in the case of REMOTE_AUDIO_STATE_REASON_NETWORK_RECOVERY, REMOTE_AUDIO_STATE_REASON_LOCAL_UNMUTED or REMOTE_AUDIO_STATE_REASON_REMOTE_UNMUTED.

REMOTE_AUDIO_STATE_FROZEN

3: The remote audio is frozen. The SDK reports this state in the case of REMOTE_AUDIO_STATE_REASON_NETWORK_CONGESTION.

REMOTE_AUDIO_STATE_FAILED

4: The remote audio fails to start. The SDK reports this state in the case of REMOTE_AUDIO_STATE_REASON_INTERNAL.

Enumerator

REMOTE_VIDEO_STATE_REASON_INTERNAL

0: The SDK reports this reason when the video state changes.

REMOTE_VIDEO_STATE_REASON_NETWORK_CONGESTION

1: The remote user's network is congested. If the network conditions are persistently poor, display a pop-up box in the application that says "The remote user's network conditions are poor".

REMOTE_VIDEO_STATE_REASON_NETWORK_RECOVERY

2: The remote user's network conditions are restored from congested to normal. You can display a pop-up box in the application that says "The remote user's network conditions have improved".

REMOTE_VIDEO_STATE_REASON_LOCAL_MUTED

3: The local user stops receiving the remote video stream or disables the video module. You can close the window to render the remote user's video and display a pop-up box in the application that says "You have stopped receiving video from the remote user".

REMOTE_VIDEO_STATE_REASON_LOCAL_UNMUTED

4: The local user resumes receiving the remote video stream or enables the video module. You can restore the window to render the remote user's video and display a pop-up box in the application that says "You have resumed receiving video from the remote user".

REMOTE_VIDEO_STATE_REASON_REMOTE_MUTED

5: The remote user stops sending the video stream or disables the video module. You can close the window to render the remote user's video, use an icon in the list of users in the application user interface to show that the remote user has stopped sending video, and display a pop-up box in the application that says "The remote user has disabled the camera".

REMOTE_VIDEO_STATE_REASON_REMOTE_UNMUTED

6: The remote user resumes sending the video stream or enables the video module. You can restore the window to render the remote user's video, use an icon in the list of users in the application user interface to show that the remote user has resumed sending video, and display a pop-up box in the application that says "The remote user has enabled the camera".

REMOTE_VIDEO_STATE_REASON_REMOTE_OFFLINE

7: The remote user leaves the channel. You can close the window to render the remote user's video and remove the remote user from the user list in the application user interface.

REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK

8: The remote audio-and-video stream falls back to the audio-only stream due to poor network conditions. You can close the window to render the remote user's video and display a pop-up box in the application that says "The remote user's network conditions are poor".

REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK_RECOVERY

9: The remote audio-only stream switches back to the audio-and-video stream after the network conditions improve. You can restore the window to render the remote user's video and display a pop-up box in the application that says "The remote user's network conditions are poor".

Enumerator

REMOTE_VIDEO_STATE_STOPPED

0: The remote video is in the initial state. The SDK reports this state in the case of REMOTE_VIDEO_STATE_REASON_LOCAL_MUTED, REMOTE_VIDEO_STATE_REASON_REMOTE_MUTED or REMOTE_VIDEO_STATE_REASON_REMOTE_OFFLINE.

REMOTE_VIDEO_STATE_STARTING

1: The first remote video packet is received.

REMOTE_VIDEO_STATE_DECODING

2: The remote video stream is decoded and plays normally. The SDK reports this state in the case of REMOTE_VIDEO_STATE_REASON_NETWORK_RECOVERY, REMOTE_VIDEO_STATE_REASON_LOCAL_UNMUTED,REMOTE_VIDEO_STATE_REASON_REMOTE_UNMUTED, or REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK_RECOVERY.

REMOTE_VIDEO_STATE_FROZEN

3: The remote video is frozen. The SDK reports this state in the case of REMOTE_VIDEO_STATE_REASON_NETWORK_CONGESTION or REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK.

REMOTE_VIDEO_STATE_FAILED

4: The remote video fails to start. The SDK reports this state in the case of REMOTE_VIDEO_STATE_REASON_INTERNAL.

Enumerator

REMOTE_VIDEO_STREAM_HIGH

0: High-quality video stream.

REMOTE_VIDEO_STREAM_LOW

1: Low-quality video stream.

Enumerator

RENDER_MODE_HIDDEN

1: Uniformly scale the video until one of its dimension fits the boundary (zoomed to fit). Hidden mode. One dimension of the video may have clipped contents.

RENDER_MODE_FIT

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

RENDER_MODE_ADAPTIVE

Deprecated:

3: This mode is deprecated.

RENDER_MODE_FILL

4: The fill mode. In this mode, the SDK stretches or zooms the video to fill the display window.

Deprecated

Enumerator

RTMP_STREAM_LIFE_CYCLE_BIND2CHANNEL

Bind to the channel lifecycle. If all hosts leave the channel, the CDN live streaming stops after 30 seconds.

RTMP_STREAM_LIFE_CYCLE_BIND2OWNER

Bind to the owner of the RTMP stream. If the owner leaves the channel, the CDN live streaming stops immediately.

Enumerator

RTMP_STREAM_PUBLISH_ERROR_OK

0: The RTMP or RTMPS streaming publishes successfully.

RTMP_STREAM_PUBLISH_ERROR_INVALID_ARGUMENT

1: Invalid argument used. Please check the parameter setting. For example, if you do not call SetLiveTranscoding to set the transcoding parameters before calling AddPublishStreamUrl, the SDK returns this error.

RTMP_STREAM_PUBLISH_ERROR_ENCRYPTED_STREAM_NOT_ALLOWED

2: The RTMP or RTMPS streaming is encrypted and cannot be published.

RTMP_STREAM_PUBLISH_ERROR_CONNECTION_TIMEOUT

3: Timeout for the RTMP or RTMPS streaming. Call the AddPublishStreamUrl method to publish the streaming again.

RTMP_STREAM_PUBLISH_ERROR_INTERNAL_SERVER_ERROR

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

RTMP_STREAM_PUBLISH_ERROR_RTMP_SERVER_ERROR

5: An error occurs in the CDN server.

RTMP_STREAM_PUBLISH_ERROR_TOO_OFTEN

6: The RTMP or RTMPS streaming publishes too frequently.

RTMP_STREAM_PUBLISH_ERROR_REACH_LIMIT

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

RTMP_STREAM_PUBLISH_ERROR_NOT_AUTHORIZED

8: The host manipulates other hosts' URLs. For example, the host updates or stops other hosts' streams. Check your app logic.

RTMP_STREAM_PUBLISH_ERROR_STREAM_NOT_FOUND

9: Agora's server fails to find the RTMP or RTMPS streaming.

RTMP_STREAM_PUBLISH_ERROR_FORMAT_NOT_SUPPORTED

10: The format of the RTMP or RTMPS streaming URL is not supported. Check whether the URL format is correct.

RTMP_STREAM_PUBLISH_ERROR_NOT_BROADCASTER

11: The user role is not host, so the user cannot use the CDN live streaming function. Check your application code logic.

RTMP_STREAM_PUBLISH_ERROR_TRANSCODING_NO_MIX_STREAM

The UpdateRtmpTranscoding or SetLiveTranscoding method is called to update the transcoding configuration in a scenario where there is streaming without transcoding. Check your application code logic.

RTMP_STREAM_PUBLISH_ERROR_NET_DOWN

14: Errors occurred in the host's network.

RTMP_STREAM_PUBLISH_ERROR_INVALID_APPID

15: Your App ID does not have permission to use the CDN live streaming function. Refer to Prerequisites to enable the CDN live streaming permission.

RTMP_STREAM_UNPUBLISH_ERROR_OK

100: The streaming has been stopped normally. After you call RemovePublishStreamUrl to stop streaming, the SDK returns this value.

Enumerator

RTMP_STREAM_PUBLISH_STATE_IDLE

0: The Media Push has not started or has ended. This state is also triggered after you remove a RTMP or RTMPS stream from the CDN by calling RemovePublishStreamUrl.

RTMP_STREAM_PUBLISH_STATE_CONNECTING

1: The SDK is connecting to Agora's streaming server and the CDN server. This state is triggered after you call the AddPublishStreamUrlmethod.

RTMP_STREAM_PUBLISH_STATE_RUNNING

2: The RTMP or RTMPS streaming publishes. The SDK successfully publishes the RTMP or RTMPS streaming and returns this state.

RTMP_STREAM_PUBLISH_STATE_RECOVERING

3: The RTMP or RTMPS streaming is recovering. When exceptions occur to the CDN, or the streaming is interrupted, the SDK tries to resume RTMP or RTMPS streaming and returns this state.

• If the SDK successfully resumes the streaming, RTMP_STREAM_PUBLISH_STATE_RUNNING(2) returns.
• If the streaming does not resume within 60 seconds or server errors occur, RTMP_STREAM_PUBLISH_STATE_FAILURE(4) returns. You can also reconnect to the server by calling the RemovePublishStreamUrl and AddPublishStreamUrl methods.

RTMP_STREAM_PUBLISH_STATE_FAILURE

4: The RTMP or RTMPS streaming fails. See the errCode parameter for the detailed error information. You can also call the AddPublishStreamUrl method to publish the RTMP or RTMPS streaming again.

RTMP_STREAM_PUBLISH_STATE_DISCONNECTING

5: The SDK is disconnecting from the Agora streaming server and CDN. When you call RemovePublishStreamUrl or StopRtmpStream to stop the streaming normally, the SDK reports the streaming state as RTMP_STREAM_PUBLISH_STATE_DISCONNECTING, RTMP_STREAM_PUBLISH_STATE_IDLE in sequence.

Enumerator

RTMP_STREAMING_EVENT_FAILED_LOAD_IMAGE

1: An error occurs when you add a background image or a watermark image in the media push.

RTMP_STREAMING_EVENT_URL_ALREADY_IN_USE

2: The streaming URL is already being used for CDN live streaming. If you want to start new streaming, use a new streaming URL.

RTMP_STREAMING_EVENT_ADVANCED_FEATURE_NOT_SUPPORT

3: The feature is not supported.

RTMP_STREAMING_EVENT_REQUEST_TOO_OFTEN

4: Reserved.

Enumerator

STREAM_FALLBACK_OPTION_DISABLED

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

STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW

1: Under poor downlink network conditions, the remote video stream, to which you subscribe, falls back to the low-quality (low resolution and low bitrate) video stream. This option is only valid for SetRemoteSubscribeFallbackOption. This option is invalid for SetLocalPublishFallbackOption method.

STREAM_FALLBACK_OPTION_AUDIO_ONLY

2: Under poor uplink network conditions, the published video stream falls back to audio-only. Under poor downlink network conditions, the remote video stream, to which you subscribe, first falls back to the low-quality (low resolution and low bitrate) video stream; and then to an audio-only stream if the network conditions worsen.

Enumerator

PUB_STATE_IDLE

0: The initial publishing state after joining the channel.

PUB_STATE_NO_PUBLISHED

1: Fails to publish the local stream. Possible reasons:

• The local user calls MuteLocalAudioStream(true) or MuteLocalVideoStream(true) to stop sending the local media stream.
• The local user calls DisableAudio or DisableVideo to disable the local audio or video module.
• The local user calls EnableLocalAudio(false) or EnableLocalVideo(false) to disable the local audio or video capture.
• The role of the local user is audience.

PUB_STATE_PUBLISHING

2: Publishing.

PUB_STATE_PUBLISHED

3: Publishes successfully.

Enumerator

SUB_STATE_IDLE

0: The initial subscribing state after joining the channel.

SUB_STATE_NO_SUBSCRIBED

1: Fails to subscribe to the remote stream. Possible reasons:

• The remote user:
  • Calls MuteLocalAudioStream(true) or MuteLocalVideoStream(true) to stop sending local media stream.
  • Calls DisableAudio or DisableVideo to disable the local audio or video module.
  • Calls EnableLocalAudio(false) or EnableLocalVideo(false) to disable the local audio or video capture.
  • The role of the remote user is audience.
• The local user calls the following methods to stop receiving remote streams:
  • Calls MuteRemoteAudioStream(true), MuteAllRemoteAudioStreams(true) or SetDefaultMuteAllRemoteAudioStreams(true) to stop receiving the remote audio streams.
  • Calls MuteRemoteVideoStream(true), MuteAllRemoteVideoStreams(true) or SetDefaultMuteAllRemoteVideoStreams(true) to stop receiving the remote video streams.

SUB_STATE_SUBSCRIBING

2: Subscribing.

SUB_STATE_SUBSCRIBED

3: Subscribes to and receives the remote stream successfully.

Since

v3.5.1

Enumerator

SR_STATE_REASON_SUCCESS

0: Super resolution is successfully enabled.

SR_STATE_REASON_STREAM_OVER_LIMITATION

1: The original resolution of the remote video is beyond the range where super resolution can be applied.

SR_STATE_REASON_USER_COUNT_OVER_LIMITATION

2: Super resolution is already being used to boost another remote user’s video.

SR_STATE_REASON_DEVICE_NOT_SUPPORTED

3: The device does not support using super resolution.

Enumerator

UPLOAD_SUCCESS

0: Successfully upload the log files.

UPLOAD_NET_ERROR

1: Network error. Check the network connection and call UploadLogFile again to upload the log file.

UPLOAD_SERVER_ERROR

2: An error occurs in the Agora server. Try uploading the log files later.

Enumerator

VOICE_CONVERSION_OFF

Turn off voice conversion effects and use the original voice.

VOICE_CHANGER_NEUTRAL

A gender-neutral voice. To avoid audio distortion, ensure that you use this enumerator to process a female-sounding voice.

VOICE_CHANGER_SWEET

A sweet voice. To avoid audio distortion, ensure that you use this enumerator to process a female-sounding voice.

VOICE_CHANGER_SOLID

A steady voice. To avoid audio distortion, ensure that you use this enumerator to process a male-sounding voice.

VOICE_CHANGER_BASS

A deep voice. To avoid audio distortion, ensure that you use this enumerator to process a male-sounding voice.

Enumerator

USER_OFFLINE_QUIT

0: The user quits the call.

USER_OFFLINE_DROPPED

1: The SDK times out and the user drops offline because no data packet is received within a certain period of time.

Attention: If the user quits the call and the message is not passed to the SDK (due to an unreliable channel), the SDK assumes the user dropped offline.

USER_OFFLINE_BECOME_AUDIENCE

2: The user switches the client role from the host to the audience.

Enumerator

VIDEO_BUFFER_RAW_DATA

1: The video buffer in the format of raw data.

Enumerator

VIDEO_CAPTURE_UNKNOWN

Unknown type.

VIDEO_CAPTURE_CAMERA

(Default) Video captured by the camera.

VIDEO_CAPTURE_SCREEN

Video for screen sharing.

VIDEO_CODEC_PROFILE_BASELINE

66: Baseline video codec profile. Generally used for video calls on mobile phones.

VIDEO_CODEC_PROFILE_MAIN

77: Main video codec profile. Generally used in mainstream electronics such as MP4 players, portable video players, PSP, and iPads.

VIDEO_CODEC_PROFILE_HIGH

100: (Default) High video codec profile. Generally used in high-resolution live streaming or television.

Enumerator

VIDEO_CODEC_VP8

Standard VP8.

VIDEO_CODEC_H264

Standard H.264.

VIDEO_CODEC_EVP

Enhanced VP8.

VIDEO_CODEC_E264

Enhanced H.264.

Enumerator

VIDEO_CODEC_H264_FOR_STREAM

1: (Default) H.264.

VIDEO_CODEC_H264_FOR_STREAM

2: H.265.

Enumerator

CONTENT_HINT_NONE

(Default) No content hint.

CONTENT_HINT_MOTION

Motion-intensive content. Choose this option if you prefer smoothness or when you are sharing a video clip, movie, or video game.

CONTENT_HINT_DETAILS

Motionless content. Choose this option if you prefer sharpness or when you are sharing a picture, PowerPoint slides, or texts.

Enumerator

VIDEO_DENOISER_AUTO

0: (Default) Automatic mode. The SDK automatically enables or disables the video noise reduction feature according to the ambient light.

VIDEO_DENOISER_MANUAL

Manual mode. Users need to enable or disable the video noise reduction feature manually.

Enumerator

VIDEO_DENOISER_LEVEL_HIGH_QUALITY

0: (Default) Promotes video quality during video noise reduction. VIDEO_DENOISER_LEVEL_HIGH_QUALITY balances performance consumption and video noise reduction quality. The performance consumption is moderate, the video noise reduction speed is moderate, and the overall video quality is optimal.

VIDEO_DENOISER_LEVEL_FAST

Promotes reducing performance consumption during video noise reduction. VIDEO_DENOISER_LEVEL_FAST prioritizes reducing performance consumption over video noise reduction quality. The performance consumption is lower, and the video noise reduction speed is faster. To avoid a noticeable shadowing effect (shadows trailing behind moving objects) in the processed video, Agora recommends that you use VIDEO_DENOISER_LEVEL_FAST when the camera is fixed.

VIDEO_DENOISER_LEVEL_STRENGTH

Enhanced video noise reduction. VIDEO_DENOISER_LEVEL_STRENGTH prioritizes video noise reduction quality over reducing performance consumption. The performance consumption is higher, the video noise reduction speed is slower, and the video noise reduction quality is better. If VIDEO_DENOISER_LEVEL_STRENGTH is not enough for your video noise reduction needs, you can use VIDEO_DENOISER_LEVEL_STRENGTH.

Enumerator

FRAME_TYPE_YUV420

The video data format is YUV420.

FRAME_TYPE_YUV422

1: YUV422.

FRAME_TYPE_RGBA

2: RGBA.

Enumerator

VIDEO_MIRROR_MODE_AUTO

0: (Default) The SDK determines the mirror mode.

VIDEO_MIRROR_MODE_ENABLED

1: Enable mirror mode.

VIDEO_MIRROR_MODE_DISABLED

2: Disable mirror mode.

Enumerator

POSITION_POST_CAPTURER

1: The post-capturer position, which corresponds to the video data in the OnCaptureVideoFrame callback.

POSITION_PRE_RENDERER

2: The pre-renderer position, which corresponds to the video data in the OnRenderVideoFrame callback.

POSITION_PRE_ENCODER

4: The pre-encoder position, which corresponds to the video data in the OnPreEncodeVideoFrame callback.

Enumerator

VIDEO_PIXEL_UNKNOWN

0: The format is known.

VIDEO_PIXEL_I420

1: The format is I420.

VIDEO_PIXEL_BGRA

2: The format is BGRA.

VIDEO_PIXEL_NV21

3: The format is NV21.

VIDEO_PIXEL_RGBA

4: The format is RGBA.

VIDEO_PIXEL_IMC2

5: The format is IMC2.

VIDEO_PIXEL_ARGB

7: The format is ARGB.

VIDEO_PIXEL_NV12

8: The format is NV12.

VIDEO_PIXEL_I422

16: The video pixel format is I422.

VIDEO_TEXTURE_2D

17: The video pixel format is GL_TEXTURE_2D.

VIDEO_TEXTURE_OES

18: The video pixel format is GL_TEXTURE_OES.

Deprecated

Enumerator

VIDEO_PROFILE_LANDSCAPE_120P

0: 160 × 120, frame rate 15 fps, bitrate 65 Kbps.

VIDEO_PROFILE_LANDSCAPE_120P_3

2: 120 × 120, frame rate 15 fps, bitrate 50 Kbps.

VIDEO_PROFILE_LANDSCAPE_180P

10: 320 × 180, frame rate 15 fps, bitrate 140 Kbps.

VIDEO_PROFILE_LANDSCAPE_180P_3

12: 180 × 180, frame rate 15 fps, bitrate 100 Kbps.

VIDEO_PROFILE_LANDSCAPE_180P_4

13: 240 × 180, frame rate 15 fps, bitrate 120 Kbps.

VIDEO_PROFILE_LANDSCAPE_240P

20: 320 × 240, frame rate 15 fps, bitrate 200 Kbps.

VIDEO_PROFILE_LANDSCAPE_240P_3

22: 240 × 240, frame rate 15 fps, bitrate 140 Kbps.

VIDEO_PROFILE_LANDSCAPE_240P_4

23: 424 × 240, frame rate 15 fps, bitrate 220 Kbps.

VIDEO_PROFILE_LANDSCAPE_360P

30: 640 × 360, frame rate 15 fps, bitrate 400 Kbps.

VIDEO_PROFILE_LANDSCAPE_360P_3

32: 360 × 360, frame rate 15 fps, bitrate 260 Kbps.

VIDEO_PROFILE_LANDSCAPE_360P_4

33: 640 × 360, frame rate 30 fps, bitrate 600 Kbps.

VIDEO_PROFILE_LANDSCAPE_360P_6

35: 360 × 360, frame rate 30 fps, bitrate 400 Kbps.

VIDEO_PROFILE_LANDSCAPE_360P_7

36: 480 × 360, frame rate 15 fps, bitrate 320 Kbps.

VIDEO_PROFILE_LANDSCAPE_360P_8

37: 480 × 360, frame rate 30 fps, bitrate 490 Kbps.

VIDEO_PROFILE_LANDSCAPE_360P_9

38: 640 × 360, frame rate 15 fps, bitrate 800 Kbps.

Attention: This profile applies only to the live streaming channel profile.

VIDEO_PROFILE_LANDSCAPE_360P_10

39: 640 × 360, frame rate 24 fps, bitrate 800 Kbps.

Attention: This profile applies only to the live streaming channel profile.

VIDEO_PROFILE_LANDSCAPE_360P_11

100: 640 × 360, frame rate 24 fps, bitrate 1000 Kbps.

Attention: This profile applies only to the live streaming channel profile.

VIDEO_PROFILE_LANDSCAPE_480P

40: 640 × 480, frame rate 15 fps, bitrate 500 Kbps.

VIDEO_PROFILE_LANDSCAPE_480P_3

42: 480 × 480, frame rate 15 fps, bitrate 400 Kbps.

VIDEO_PROFILE_LANDSCAPE_480P_4

43: 640 × 480, frame rate 30 fps, bitrate 750 Kbps.

VIDEO_PROFILE_LANDSCAPE_480P_6

45: 480 × 480, frame rate 30 fps, bitrate 600 Kbps.

VIDEO_PROFILE_LANDSCAPE_480P_8

47: 848 × 480, frame rate 15 fps, bitrate 610 Kbps.

VIDEO_PROFILE_LANDSCAPE_480P_9

48: 848 × 480, frame rate 30 fps, bitrate 930 Kbps.

VIDEO_PROFILE_LANDSCAPE_480P_10

49: 640 × 480, frame rate 10 fps, bitrate 400 Kbps.

VIDEO_PROFILE_LANDSCAPE_720P

50: 1280 × 720, frame rate 15 fps, bitrate 1130 Kbps.

VIDEO_PROFILE_LANDSCAPE_720P_3

52: 1280 × 720, frame rate 30 fps, bitrate 1710 Kbps.

VIDEO_PROFILE_LANDSCAPE_720P_5

54: 960 × 720, frame rate 15 fps, bitrate 910 Kbps.

VIDEO_PROFILE_LANDSCAPE_720P_6

55: 960 × 720, frame rate 30 fps, bitrate 1380 Kbps.

VIDEO_PROFILE_LANDSCAPE_1080P

60: 1920 × 1080, frame rate 15 fps, bitrate 2080 Kbps.

VIDEO_PROFILE_LANDSCAPE_1080P_3

60: 1920 × 1080, frame rate 30 fps, bitrate 3150 Kbps.

VIDEO_PROFILE_LANDSCAPE_1080P_5

64: 1920 × 1080, frame rate 60 fps, bitrate 4780 Kbps.

VIDEO_PROFILE_PORTRAIT_120P

1000: 120 × 160, frame rate 15 fps, bitrate 65 Kbps.

VIDEO_PROFILE_PORTRAIT_120P_3

1002: 120 × 120, frame rate 15 fps, bitrate 50 Kbps.

VIDEO_PROFILE_PORTRAIT_180P

1010: 180 × 320, frame rate 15 fps, bitrate 140 Kbps.

VIDEO_PROFILE_PORTRAIT_180P_3

1012: 180 × 180, frame rate 15 fps, bitrate 100 Kbps.

VIDEO_PROFILE_PORTRAIT_180P_4

1013: 180 × 240, frame rate 15 fps, bitrate 120 Kbps.

VIDEO_PROFILE_PORTRAIT_240P

1020: 240 × 320, frame rate 15 fps, bitrate 200 Kbps.

VIDEO_PROFILE_PORTRAIT_240P_3

1022: 240 × 240, frame rate 15 fps, bitrate 140 Kbps.

VIDEO_PROFILE_PORTRAIT_240P_4

1023: 240 × 424, frame rate 15 fps, bitrate 220 Kbps.

VIDEO_PROFILE_PORTRAIT_360P

1030: 360 × 640, frame rate 15 fps, bitrate 400 Kbps.

VIDEO_PROFILE_PORTRAIT_360P_3

1032: 360 × 360, frame rate 15 fps, bitrate 260 Kbps.

VIDEO_PROFILE_PORTRAIT_360P_4

1033: 360 × 640, frame rate 15 fps, bitrate 600 Kbps.

VIDEO_PROFILE_PORTRAIT_360P_6

1035: 360 × 360, frame rate 30 fps, bitrate 400 Kbps.

VIDEO_PROFILE_PORTRAIT_360P_7

1036: 360 × 480, frame rate 15 fps, bitrate 320 Kbps.

VIDEO_PROFILE_PORTRAIT_360P_8

1037: 360 × 480, frame rate 30 fps, bitrate 490 Kbps.

VIDEO_PROFILE_PORTRAIT_360P_9

1038: 360 × 640, frame rate 15 fps, bitrate 800 Kbps.

Attention: This profile applies only to the live streaming channel profile.

VIDEO_PROFILE_PORTRAIT_360P_10

1039: 360 × 640, frame rate 24 fps, bitrate 800 Kbps.

Attention: This profile applies only to the live streaming channel profile.

VIDEO_PROFILE_PORTRAIT_360P_11

1100: 360 × 640, frame rate 24 fps, bitrate 1000 Kbps.

Attention: This profile applies only to the live streaming channel profile.

VIDEO_PROFILE_PORTRAIT_480P

1040: 480 × 640, frame rate 15 fps, bitrate 500 Kbps.

VIDEO_PROFILE_PORTRAIT_480P_3

1042: 480 × 480, frame rate 15 fps, bitrate 400 Kbps.

VIDEO_PROFILE_PORTRAIT_480P_4

1043: 480 × 640, frame rate 30 fps, bitrate 750 Kbps.

VIDEO_PROFILE_PORTRAIT_480P_6

1045: 480 × 480, frame rate 30 fps, bitrate 600 Kbps.

VIDEO_PROFILE_PORTRAIT_480P_8

1047: 480 × 848, frame rate 15 fps, bitrate 610 Kbps.

VIDEO_PROFILE_PORTRAIT_480P_9

1048: 480 × 848, frame rate 30 fps, bitrate 930 Kbps.

VIDEO_PROFILE_PORTRAIT_480P_10

1049: 480 × 640, frame rate 10 fps, bitrate 400 Kbps.

VIDEO_PROFILE_PORTRAIT_720P

1050: 720 × 1280, frame rate 15 fps, bitrate 1130 Kbps.

VIDEO_PROFILE_PORTRAIT_720P_3

1052: 720 × 1280, frame rate 30 fps, bitrate 1710 Kbps.

VIDEO_PROFILE_PORTRAIT_720P_5

1054: 720 × 960, frame rate 15 fps, bitrate 910 Kbps.

VIDEO_PROFILE_PORTRAIT_720P_6

1055: 720 × 960, frame rate 30 fps, bitrate 1380 Kbps.

VIDEO_PROFILE_PORTRAIT_1080P

1060: 1080 × 1920, frame rate 15 fps, bitrate 2080 Kbps.

VIDEO_PROFILE_PORTRAIT_1080P_3

1062: 1080 × 1920, frame rate 30 fps, bitrate 3150 Kbps.

VIDEO_PROFILE_PORTRAIT_1080P_5

1064: 1080 × 1920, frame rate 60 fps, bitrate 4780 Kbps.

VIDEO_PROFILE_DEFAULT

(Default) 640 × 360, frame rate 15 fps, bitrate 400 Kbps.

Since

v3.5.0

Enumerator

VIRTUAL_BACKGROUND_SOURCE_STATE_REASON_SUCCESS

0: The virtual background is successfully enabled.

VIRTUAL_BACKGROUND_SOURCE_STATE_REASON_IMAGE_NOT_EXIST

1: The custom background image does not exist. Please check the value of source in VirtualBackgroundSource.

VIRTUAL_BACKGROUND_SOURCE_STATE_REASON_COLOR_FORMAT_NOT_SUPPORTED

2: The color format of the custom background image is invalid. Please check the value of color in VirtualBackgroundSource.

VIRTUAL_BACKGROUND_SOURCE_STATE_REASON_DEVICE_NOT_SUPPORTED

3: The device does not support using the virtual background.

Enumerator

VOICE_BEAUTIFIER_OFF

Turn off voice beautifier effects and use the original voice.

CHAT_BEAUTIFIER_MAGNETIC

A more magnetic voice.

Attention: Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may experience vocal distortion.

CHAT_BEAUTIFIER_FRESH

A fresher voice.

Attention: Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may experience vocal distortion.

CHAT_BEAUTIFIER_VITALITY

A more vital voice.

Attention: Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may experience vocal distortion.

SINGING_BEAUTIFIER

Singing beautifier effect.

• If you call SetVoiceBeautifierPreset(SINGING_BEAUTIFIER), you can beautify a male-sounding voice and add a reverberation effect that sounds like singing in a small room. Agora recommends using this enumerator to process a male-sounding voice; otherwise, you might experience vocal distortion.
• If you call SetVoiceBeautifierParameters(SINGING_BEAUTIFIER, param1, param2), you can beautify a male- or female-sounding voice and add a reverberation effect.

TIMBRE_TRANSFORMATION_VIGOROUS

A more vigorous voice.

TIMBRE_TRANSFORMATION_DEEP

A deep voice.

TIMBRE_TRANSFORMATION_MELLOW

A mellower voice.

TIMBRE_TRANSFORMATION_FALSETTO

Falsetto.

TIMBRE_TRANSFORMATION_FULL

A fuller voice.

TIMBRE_TRANSFORMATION_CLEAR

A clearer voice.

TIMBRE_TRANSFORMATION_RESOUNDING

A more resounding voice.

TIMBRE_TRANSFORMATION_RINGING

A more ringing voice.

Deprecated

Deprecated as of v3.2.0.

Enumerator

VOICE_CHANGER_OFF

The original voice (no local voice change).

VOICE_CHANGER_OLDMAN

The voice of an old man.

VOICE_CHANGER_BABYBOY

The voice of a little boy.

VOICE_CHANGER_BABYGIRL

The voice of a little girl.

VOICE_CHANGER_ZHUBAJIE

The voice of Zhu Bajie, a character in Journey to the West who has a voice like that of a growling bear.

VOICE_CHANGER_ETHEREAL

The ethereal voice.

VOICE_CHANGER_HULK

The voice of Hulk.

VOICE_BEAUTY_VIGOROUS

A more vigorous voice.

VOICE_BEAUTY_DEEP

A deeper voice.

VOICE_BEAUTY_MELLOW

A mellower voice.

VOICE_BEAUTY_FALSETTO

Falsetto.

VOICE_BEAUTY_FULL

A fuller voice.

VOICE_BEAUTY_CLEAR

A clearer voice.

VOICE_BEAUTY_RESOUNDING

A more resounding voice.

VOICE_BEAUTY_RINGING

A more ringing voice.

VOICE_BEAUTY_SPACIAL

A more spatially resonant voice.

GENERAL_BEAUTY_VOICE_MALE_MAGNETIC

(For male only) A more magnetic voice. Do not use it when the speaker is a female; otherwise, voice distortion occurs.

GENERAL_BEAUTY_VOICE_FEMALE_FRESH

(For female only) A fresher voice. Do not use it when the speaker is a male; otherwise, voice distortion occurs.

GENERAL_BEAUTY_VOICE_FEMALE_VITALITY

(For female only) A more vital voice. Do not use it when the speaker is a male; otherwise, voice distortion occurs.

Attributes

filePath

The file path.

durationMs

The file duration (ms).

Attributes

type

The type of the audio frame. See AUDIO_FRAME_TYPE.

samples

The number of samples per channel in the audio frame.

bytesPerSample

The number of bytes per audio sample, which is usually 16-bit (2 bytes).

channels

The number of audio channels (the data are interleaved if stereo).

• 1: Mono.
• 2: Stereo.

samplesPerSec

The number of samples per channel in the audio frame.

buffer

The data buffer of the audio frame. When the audio frame uses a stereo channel, the data buffer is interleaved.

Buffer data size: buffer = samples × channels × bytesPerSample.

bufferPtr

Pointer to the data buffer.

renderTimeMs

The timestamp (ms) of the external audio frame.

You can use this timestamp to restore the order of the captured audio frame, and synchronize audio and video frames in video scenarios, including scenarios where external video sources are used.

avsync_type

A reserved parameter.

Attributes

filePath

The absolute path (including the filename extensions) of the recording file. For example: C:\music\audio.aac .

Attention: Ensure that the directory for the log files exists and is writable.

recordingChannel

The recorded audio channel. The following values are supported:

• 1: (Default) Mono channel.
• Dual channel.

Attention: The actual recorded audio channel is related to the audio channel that you capture. If the captured audio is mono and recordingChannel is 2, the recorded audio is the dual-channel data that is copied from mono data, not stereo. If the captured audio is dual channel and recordingChannel is 1, the recorded audio is the mono data that is mixed by dual-channel data. The integration scheme also affects the final recorded audio channel. Therefore, to record in stereo, contact technical support for assistance.

recordingQuality

Recording quality. For details, see AUDIO_RECORDING_QUALITY_TYPE .

Attention: Note: This parameter applies to AAC files only.

recordingPosition

The recording content. For details, see AUDIO_RECORDING_POSITION .

recordingSampleRate

Recording sample rate (Hz).

• 16000
• (Default) 32000
• 44100
• 48000

Attention: If you set this parameter as 44100 or 48000, Agora recommends recording WAV files or AAV files whose recordingQuality is AUDIO_RECORDING_QUALITY_MEDIUM or AUDIO_RECORDING_QUALITY_HIGH for better recording quality.

Attributes

uid

The user ID.

• In the local user's callback, uid = 0.
• In the remote users' callback, uid is the user ID of a remote user whose instantaneous volume is one of the three highest.

volume

The volume of the user. The value ranges between 0 (lowest volume) and 255 (highest volume). If the user calls StartAudioMixing [2/2], the value of volume is the volume after audio mixing.

vad

The voice activity status of the local user.

• 0: The local user is not speaking.
• 1: The local user is speaking.

Attention:

• The vad parameter does not report the voice activity status of remote users. In the remote users' callback, the value of vad is always 0.
• To use this parameter, you must set reportVad to true when calling EnableAudioVolumeIndication.

channelId

The name of the channel that the user is in.

Attributes

lighteningContrastLevel

contrast, often with lighteningLevel . The larger the value, the greater the contrast between light and dark. For more details, see LIGHTENING_CONTRAST_LEVEL.

lighteningLevel

The brightness level. The value ranges from 0.0 (original) to 1.0. The default is > . The greater the value, the greater the degree of whitening.

smoothnessLevel

The value ranges from 0.0 (original) to 1.0. The default value is 0.5. The greater the value, the greater the degree of skin grinding.

rednessLevel

The value ranges from 0.0 (original) to 1.0. The default value is 0.1. The larger the value, the greater the rosy degree.

sharpnessLevel

The sharpness level. The value ranges from 0.0 (original) to 1.0. The default value is 0.10.30.0. The larger the value, the greater the sharpening degree.

Attributes

preference

The camera capture preference. For details, see CAPTURER_OUTPUT_PREFERENCE.

captureWidth

The width (px) of the video image captured by the local camera. To customize the width of the video image, set preference as CAPTURER_OUTPUT_PREFERENCE_MANUAL(3) first, and then use captureWidth to set the video width.

captureHeight

The height (px) of the video image captured by the local camera. To customize the height of the video image, set preference as CAPTURER_OUTPUT_PREFERENCE_MANUAL(3) first, and then use captureHeight.

cameraDirection

This parameter applies to Android and iOS only.

The camera direction. For details, see CAMERA_DIRECTION.

Attributes

channelName

The name of the channel.

token

The token that enables the user to join the channel.

uid

User ID.

Attributes

autoSubscribeAudio

Whether to automatically subscribe to all remote audio streams when the user joins a channel:

• true: (Default) Subscribe.
• false: Do not subscribe.

This member serves a similar function to the MuteAllRemoteAudioStreams method. After joining the channel, you can call the muteAllRemoteAudioStreams method to set whether to subscribe to audio streams in the channel.

autoSubscribeVideo

Whether to subscribe to video streams when the user joins the channel:

• true: (Default) Subscribe.
• false: Do not subscribe.

This member serves a similar function to the MuteAllRemoteVideoStreams method. After joining the channel, you can call the muteAllRemoteVideoStreams method to set whether to subscribe to video streams in the channel.

publishLocalAudio

whether to publish the local audio stream when the user joins a channel.

• true: (Default) Publish the local audio.
• false: Do not publish the local audio.

This member serves a similar function to the muteLocalAudioStream method. After the user joins the channel, you can call the muteLocalAudioStream method to set whether to publish the local audio stream in the channel.

publishLocalVideo

whether to publish the local video stream when the user joins a channel.

• true: (Default) Publish the local video.
• false: Do not publish the local video.

This member serves a similar function to the muteLocalVideoStream method. After the user joins the channel, you can call the muteLocalVideoStream method to set whether to publish the local audio stream in the channel.

Attributes

srcInfo

The information of the source channel ChannelMediaInfo. It contains the following members:

• channelName: The name of the source channel. The default value is , which means the SDK applies the name of the current channel.NULL
• uid: The unique ID to identify the relay stream in the source channel. The default value is 0, which means the SDK generates a random UID. You must set it as 0.
• token: The token for joining the source channel. It is generated with the channelName and uid you set in srcInfo.
  • If you have not enabled the App Certificate, set this parameter as the default value NULL , which means the SDK applies the App ID.
  • If you have enabled the App Certificate, you must use the token generated with the channelName and uid, and the uid must be set as 0.

destInfos

The information of the destination channel ChannelMediaInfo. It contains the following members:

• channelName: The name of the destination channel.
• uid: The unique ID to identify the relay stream in the destination channel. The value ranges from 0 to (2³²-1). To avoid UID conflicts, this `UID` must be different from any other `UID` in the destination channel. The default value is 0, which means the SDK generates a random `UID`. Do not set this parameter as the `UID` of the host in the destination channel, and ensure that this `UID` is different from any other `UID` in the channel.
• token: The token for joining the destination channel. It is generated with the channelName and uid you set in destInfos.
  • If you have not enabled the App Certificate, set this parameter as the default value NULL , which means the SDK applies the App ID.
  • If you have enabled the App Certificate, you must use the token generated with the channelName and uid.

destCount

The number of destination channels. The default value is 0, and the value range is from 0 to 4. Ensure that the value of this parameter corresponds to the number of ChannelMediaInfo structs you define in destInfo.

Attributes

audienceLatencyLevel

The latency level of an audience member in interactive live streaming. See AUDIENCE_LATENCY_LEVEL_TYPE.

Attributes

strengthLevel

The level of color enhancement. The value range is [0.0, 1.0]. 0.0 is the default value, which means no color enhancement is applied to the video. The higher the value, the higher the level of color enhancement.

skinProtectLevel

The level of skin tone protection. The value range is [0.0, 1.0]. 0.0 means no skin tone protection. The higher the value, the higher the level of skin tone protection. The default value is 100.The default value is 1.0. When the level of color enhancement is higher, the portrait skin tone can be significantly distorted, so you need to set the level of skin tone protection; when the level of skin tone protection is higher, the color enhancement effect can be slightly reduced. Therefore, to get the best color enhancement effect, Agora recommends that you adjust strengthLevel and skinProtectLevel to get the most appropriate values.

Attributes

deviceName

The device name.

deviceId

The device ID.

The following table shows the SDK behaviors under different parameter settings:

Attributes

syncWithAudio

Whether to synchronize the data packet with the published audio packet.

• true: Synchronize the data packet with the audio packet.
• false: Do not synchronize the data packet with the audio packet.

When you set the data packet to synchronize with the audio, then if the data packet delay is within the audio delay, the SDK triggers the OnStreamMessage callback when the synchronized audio packet is played out. Do not set this parameter as true if you need the receiver to receive the data packet immediately. Agora recommends that you set this parameter to `true` only when you need to implement specific functions, for example lyric synchronization.

ordered

Whether the SDK guarantees that the receiver receives the data in the sent order.

• true: Guarantee that the receiver receives the data in the sent order.
• false: Do not guarantee that the receiver receives the data in the sent order.

Do not set this parameter as true if you need the receiver to receive the data packet immediately.

Attributes

view

The view used to render the local user's video. This parameter is only applicable to scenarios testing video devices, that is, when the enableVideo member is set to true.

enableAudio

Whether to enable the audio device for the call loop test:

• true: (Default) Enables the audio device. To test the audio device, set this parameter as true.
• false: Disables the audio device.

enableVideo

Whether to enable the video device for the call loop test:

• true: (Default) Enables the video device. To test the video device, set this parameter as true.
• false: Disables the video device.

token

The token used to secure the audio and video call loop test. If you do not enable App Certificate in Agora Console, you do not need to pass a value in this parameter; if you have enabled App Certificate in Agora Console, you must pass a token in this parameter. The uid used when you generate the token must be 0xFFFFFFFF, and the channel name used must be the channel name that identifies each audio and video call loop test. For server-side token generation, see https://docs.agora.io/en/Interactive%20Broadcast/token_server?platform=Windows.

channelId

The channel name that identifies each audio and video call loop. To ensure proper loop test functionality, the channel name passed in to identify each loop test cannot be the same when users of the same project (App ID) perform audio and video call loop tests on different devices.

Attributes

encryptionMode

The built-in encryption mode. See ENCRYPTION_MODE. Agora recommends using AES_128_GCM2 or AES_256_GCM2 encrypted mode. These two modes support the use of salt for higher security.

encryptionKey

Encryption key in string type.

Attention: If you do not set an encryption key or set it as NULL, you cannot use the built-in encryption, and the SDK returns -2.

encryptionKdfSalt

Since

v3.4.5

Salt, 32 bytes in length. Agora recommends that you use OpenSSL to generate salt on the server side. See Media Stream Encryption for details.

Attention: This parameter takes effect only in AES_128_GCM2 or AES_256_GCM2 encrypted mode. In this case, ensure that this parameter is not 0.

Attributes

type

The video buffer type. For details, see VIDEO_BUFFER_TYPE.

format

The pixel format. For details, see VIDEO_PIXEL_FORMAT.

buffer

The video buffer.

stride

Line spacing of the incoming video frame, which must be in pixels instead of bytes. For textures, it is the width of the texture.

height

Height of the incoming video frame.

cropLeft

Raw data related parameter. The number of pixels trimmed from the left. The default value is 0.

cropTop

Raw data related parameter. The number of pixels trimmed from the top. The default value is 0.

cropRight

Raw data related parameter. The number of pixels trimmed from the right. The default value is 0.

cropBottom

Raw data related parameter. The number of pixels trimmed from the bottom. The default value is 0.

rotation

Raw data related parameter. The clockwise rotation of the video frame. You can set the rotation angle as 0, 90, 180, or 270. The default value is 0.

timestamp

Timestamp (ms) of the incoming video frame. An incorrect timestamp results in frame loss or unsynchronized audio and video.

Parameters

packet

The received audio packet, see Packet .

Returns

• true: The audio packet is received successfully.
• false: The audio packet is discarded.

Parameters

packet

The received video packet, see Packet .

Returns

• true: The video packet is received successfully.
• false: The video packet is discarded.

Parameters

packet

The sent audio packet, seePacket .

Returns

• true: The audio packet is sent successfully.
• false: The audio packet is discarded.

Parameters

packet

The sent video packet, see Packet .

Returns

• true: The video packet is sent successfully.
• false: The video packet is discarded.

Attributes

buffer

The buffer address of the sent or received data.

Attention: Agora recommends setting buffer to a value larger than 2048 bytes. Otherwise, you may encounter undefined behaviors (such as crashes).

size

The buffer size of the sent or received data.

Attributes

probeUplink

Sets whether to test the uplink network. Some users, for example, the audience members in a LIVE_BROADCASTING channel, do not need such a test.

• true: Test.
• false: Not test.

probeDownlink

Sets whether to test the downlink network:

• true: Test.
• false: Not test.

expectedUplinkBitrate

The expected maximum uplink bitrate (bps) of the local user. The value range is [100000, 5000000]. Agora recommends referring to SetVideoEncoderConfiguration to set the value.

expectedDownlinkBitrate

The expected maximum downlink bitrate (bps) of the local user. The value range is [100000,5000000].

Attributes

packetLossRate

The packet loss rate (%).

jitter

The network jitter (ms).

availableBandwidth

The estimated available bandwidth (bps).

Attributes

state

The status of the last-mile network tests. See LASTMILE_PROBE_RESULT_STATE.

uplinkReport

Results of the uplink last-mile network test. For details, see LastmileProbeOneWayResult.

downlinkReport

Results of the downlink last-mile network test. For details, see LastmileProbeOneWayResult.

rtt

The round-trip time (ms).

Attributes

width

The width of the video in pixels. The default value is 360.

• When pushing video streams to the CDN, the value range of width is [64,1920]. If the value is less than 64, Agora server automatically adjusts it to 64; if the value is greater than 1920, Agora server automatically adjusts it to 1920.
• When pushing audio streams to the CDN, set width and height as 0.

height

The height of the video in pixels. The default value is 640.

• When pushing video streams to the CDN, the value range of height is [64,1080]. If the value is less than 64, Agora server automatically adjusts it to 64; if the value is greater than 1080, Agora server automatically adjusts it to 1080.
• When pushing audio streams to the CDN, set width and height as 0.

videoBitrate

Bitrate of the output video stream for Media Push in Kbps. The default value is 400 Kbps.

You can refer to Media Pushfor how to set this parameter.

videoFramerate

Frame rate (in fps) of the output video stream set for Media Push. The default value is 15 , and the value range is (0,30].

Attention: The Agora server adjusts any value over 30 to 30.

lowLatency

Deprecated

This parameter is deprecated.

Latency mode:

• true: Low latency with unassured quality.
• false: (Default) High latency with assured quality.

videoGop

GOP (Group of Pictures) in fps of the video frames for Media Push. The default value is 30.

videoCodecProfile

Video codec profile type for Media Push. Set it as 66, 77, or 100 (default). See VIDEO_CODEC_PROFILE_TYPE for details.

Attention: If you set this parameter to any other value, Agora adjusts it to the default value.

videoCodecType

Video codec profile types for Media Push. See VIDEO_CODEC_TYPE_FOR_STREAM for details.

transcodingUsers

Manages the user layout configuration in the CDN live streaming. Agora supports a maximum of 17 transcoding users in a Media Push channel. See TranscodingUser for details.

transcodingExtraInfo

Reserved property. Extra user-defined information to send SEI for the H.264/H.265 video stream to the CDN live client. Maximum length: 4096 bytes. For more information on SEI, see SEI-related questions.

backgroundColor

The background color in RGB hex value. Value only. Do not include a preceeding #. For example, 0xFFB6C1 (light pink). The default value is 0x000000 (black).

userCount

The number of users in the interactive live streaming. The value range is [0,17].

metadata

Deprecated

This parameter is deprecated.

The metadata sent to the CDN client.

backgroundImage

The number of background images on the live video. See RtcImage for details. You can add a background image or use an array to add multiple background images. This parameter is used with backgroundImageCount.

watermark

The watermark on the live video. Watermark images must be in the PNG format. See RtcImage for details.

You can add one watermark, or add multiple watermarks using an array. This parameter is used with watermarkCount.

audioSampleRate

Self-defined audio sample rate. See AUDIO_SAMPLE_RATE_TYPE for details.

audioBitrate

Bitrate (Kbps) of the audio output stream for Media Push. The default value is 48, and the highest value is 128.

audioChannels

The number of audio channels for Media Push. Agora recommends choosing 1 (mono), or 2 (stereo) audio channels. Special players are required if you choose 3, 4, or 5.

• 1: (Default) Mono
• 2: Stereo.
• 3: Three audio channels.
• 4: Four audio channels.
• 5: Five audio channels.

audioCodecProfile

Audio codec profile type for Media Push. See AUDIO_CODEC_PROFILE_TYPE for details.

watermarkCount

The array of watermarks on the live video. See RtcImage for details.

The total number of watermarks and background images can range from 0 to 10. This parameter is used with watermark.

backgroundImageCount

The number of background images on the live video.

The total number of watermarks and background images can range from 0 to 10. This parameter is used with backgroundImage.

userConfigExtraInfo

Reserved for future use. Extra user-defined information to send the Supplemental Enhancement Information (SEI) for the H.264/H.265 video stream to the CDN live client. Maximum length: 4096 Bytes.

userConfigExtraInfo

Reserved property. Extra user-defined information to send the Supplemental Enhancement Information (SEI) for the H.264/H.265 video stream to the CDN live client. Maximum length: 4096 Bytes.

advancedFeatures

Advanced features of the Media Push with transcoding.

advancedFeatureCount

The number of enabled advanced features. The default value is 0.

Attributes

numChannels

The number of audio channels.

sentSampleRate

The sampling rate (Hz) of sending the local user's audio stream.

sentBitrate

The average bitrate (Kbps) of sending the local user's audio stream.

txPacketLossRate

The packet loss rate (%) from the local client to the Agora server before applying the anti-packet loss strategies.

Attributes

sentBitrate

The actual bitrate (Kbps) while sending the local video stream.

Attention: This value does not include the bitrate for resending the video after packet loss.

sentFrameRate

The actual frame rate (fps) while sending the local video stream.

Attention: This value does not include the frame rate for resending the video after packet loss.

encoderOutputFrameRate

The output frame rate (fps) of the local video encoder.

rendererOutputFrameRate

The output frame rate (fps) of the local video renderer.

targetBitrate

The target bitrate (Kbps) of the current encoder. This is an estimate made by the SDK based on the current network conditions.

targetFrameRate

The target frame rate (fps) of the current encoder.

qualityAdaptIndication

Quality adaption of the local video stream in the reported interval (based on the target frame rate and target bitrate). For details, see QUALITY_ADAPT_INDICATION.

encodedBitrate

The bitrate (Kbps) while encoding the local video stream.

Attention: This value does not include the bitrate for resending the video after packet loss.

encodedFrameWidth

The width of the encoded video (px).

encodedFrameHeight

The height of the encoded video (px).

encodedFrameCount

The number of the sent video frames, represented by an aggregate value.

codecType

The codec type of the local video. For details, see VIDEO_CODEC_TYPE.

txPacketLossRate

The video packet loss rate (%) from the local client to the Agora server before applying the anti-packet loss strategies.

captureFrameRate

The frame rate (fps) for capturing the local video stream.

Attributes

filePath

The absolute or relative path of the log file, which ends with \ or /. Ensure that the path for the log file exists and is writable. You can use this parameter to rename the log files.

fileSize

The size (KB) of a log file. The default value is 2014 KB. If you set fileSize to 1024 KB, the maximum aggregate size of the log files output by the SDK is 5 MB. If you set fileSize to less than 1024 KB, the setting is invalid, and the maximum size of a log file is still 1024 KB.

level

The output level of the SDK log file. See LOG_LEVEL.

Attributes

level

The low-light enhancement level. For details, see LOW_LIGHT_ENHANCE_LEVEL.

mode

The low-light enhancement mode. For details, see LOW_LIGHT_ENHANCE_MODE.

Attributes

storagePath

The absolute path (including the filename extensions) of the recording file. For example, C:\Users\<user_name>\AppData\Local\Agora\<process_name>\example.mp4 on Windows, /App Sandbox/Library/Caches/example.mp4 on iOS, /Library/Logs/example.mp4 on macOS, and /storage/emulated/0/Android/data/<package name>/files/example.mp4 on Android.

containerFormat

The format of the recording file. See MediaRecorderContainerFormat.

streamType

The recording content. See MediaRecorderStreamType.

maxDurationMs

The maximum recording duration, in milliseconds. The default value is 120,000.

recorderInfoUpdateInterval

The interval (ms) of updating the recording information. The value range is [1000,10000]. The SDK triggers the OnRecorderInfoUpdated callback to report the updated recording information according to interval you set in this parameter.

Attributes

fileName

The absolute path of the recording file.

durationMs

The recording duration, in milliseconds.

fileSize

The size of the recording file, in bytes.

Deprecated:

This class is deprecated. Please use the UpdateScreenCaptureRegion method to update the shared area.

Attributes

top

The coordinate of the top side of the shared area on the vertical axis.

left

The coordinate of the left side of the shared area on the horizontal axis.

bottom

The coordinate of the bottom side of the shared area on the vertical axis.

right

The coordinate of the right side of the shared area on the horizontal axis.

Attributes

x

The horizontal offset from the top-left corner.

y

The vertical offset from the top-left corner.

width

The width of the target area.

height

The height of the target area.

Attributes

uid

The user ID of the remote user.

quality

The quality of the audio stream sent by the user. See QUALITY_TYPE.

networkTransportDelay

The network delay (ms) from the sender to the receiver.

jitterBufferDelay

The network delay (ms) from the receiver to the jitter buffer.

Attention: This parameter does not take effect if the receiver is an audience member and audienceLatencyLevel of ClientRoleOptions is 1.

audioLossRate

The frame loss rate (%) of the remote audio stream in the reported interval.

numChannels

The number of audio channels.

receivedSampleRate

The sampling rate of the received audio stream in the reported interval.

receivedBitrate

The average bitrate (Kbps) of the received audio stream in the reported interval.

totalFrozenTime

The total freeze time (ms) of the remote audio stream after the remote user joins the channel. In a session, audio freeze occurs when the audio frame loss rate reaches 4%.

frozenRate

The total audio freeze time as a percentage (%) of the total time when the audio is available. The audio is considered available when the remote user neither stops sending the audio stream nor disables the audio module after joining the channel.

totalActiveTime

The total active time (ms) between the start of the audio call and the callback of the remote user.

The active time refers to the total duration of the remote user without the mute state.

publishDuration

The total duration (ms) of the remote audio stream.

qoeQuality

Quality of experience (QoE) of the local user when receiving the remote audio stream. See EXPERIENCE_QUALITY_TYPE.

qualityChangedReason

The reason for poor QoE of the local user when receiving the remote audio stream. See EXPERIENCE_POOR_REASON.

mosValue

The quality of the remote audio stream in the reported interval. The quality is determined by the Agora real-time audio MOS (Mean Opinion Score) measurement method. The return value range is [0, 500]. Dividing the return value by 100 gets the MOS score, which ranges from 0 to 5. The higher the score, the better the audio quality.

The subjective perception of audio quality corresponding to the Agora real-time audio MOS scores is as follows:

MOS score	Perception of audio quality
Greater than 4	Excellent. The audio sounds clear and smooth.
From 3.5 to 4	Good. The audio has some perceptible impairment but still sounds clear.
From 3 to 3.5	Fair. The audio freezes occasionally and requires attentive listening.
From 2.5 to 3	Poor. The audio sounds choppy and requires considerable effort to understand.
From 2 to 2.5	Bad. The audio has occasional noise. Consecutive audio dropouts occur, resulting in some information loss. The users can communicate only with difficulty.
Less than 2	Very bad. The audio has persistent noise. Consecutive audio dropouts are frequent, resulting in severe information loss. Communication is nearly impossible.

Attributes

uid

The user ID of the remote user sending the video stream.

delay

Deprecated:

In scenarios where audio and video are synchronized, you can get the video delay data from networkTransportDelay and jitterBufferDelay in RemoteAudioStats.

The video delay (ms).

width

The width (pixels) of the video.

height

The height (pixels) of the video.

receivedBitrate

The bitrate (Kbps) of the remote video received since the last count.

decoderOutputFrameRate

The frame rate (fps) of decoding the remote video.

rendererOutputFrameRate

The frame rate (fps) of rendering the remote video.

packetLossRate

The packet loss rate (%) of the remote video after using the anti-packet-loss technology.

rxStreamType

The type of the video stream. See REMOTE_VIDEO_STREAM_TYPE.

totalFrozenTime

The total freeze time (ms) of the remote video stream after the remote user joins the channel. In a video session where the frame rate is set to 5 fps or higher, video freezing occurs when the time interval between two adjacent video frames is more than 500 ms.

frozenRate

The total video freeze time as a percentage (%) of the total time the video is available. The video is considered available as long as that the remote user neither stops sending the video stream nor disables the video module after joining the channel.

totalActiveTime

Since

v3.0.1

The total active time (ms) of the video.

As long as the remote user/host neither stops sending the video stream nor disables the video module after joining the channel, the video is available.

publishDuration

Since

v3.1.0

The total duration (ms) of the remote video stream.

Attributes

appId

The App ID issued by Agora for your app development project. Only users who use the same App ID can join the same channel and communicate with each other.

context

The video window handler. Once set, this parameter enables you to plug or unplug the video devices while they are powered.

areaCode

The region for connection. This is an advanced feature and applies to scenarios that have regional restrictions. For details on supported regions, see AREA_CODE.

After specifying the region, the SDK connects to the Agora servers within that region.

logConfig

The configuration of the log files. See LogConfig.

By default, the SDK outputs five log files: agorasdk.log, agorasdk_1.log, agorasdk_2.log, agorasdk_3.log, and agorasdk_4.log.

Each log file has a default size of 512 KB and is encoded in UTF-8 format. The SDK writes the latest log in agorasdk.log. When agorasdk.log is full, the SDK deletes the log file with the earliest modification time among the other four, renames agorasdk.log to the name of the deleted log file, and create a new agorasdk.log to record the latest log.

This class sets the properties of the watermark and background images in the live video.

Attributes

url

The HTTP/HTTPS URL address of the image in the live video. The maximum length of this parameter is 1024 bytes.

x

The x coordinate (pixel) of the image on the video frame (taking the upper left corner of the video frame as the origin).

y

The y coordinate (pixel) of the image on the video frame (taking the upper left corner of the video frame as the origin).

width

The width (pixel) of the image on the video frame.

height

The height (pixel) of the image on the video frame.

zOrder

The layer index of the video frame. An integer. The value range is [0, 100]. 1 represents the lowest layer. 100 represents the top layer.

alpha

The transparency of the watermark or background image. The value ranges between 0.0 and 1.0:

• 0.0: Completely transparent.
• 1.0: (Default) Opaque.

Attributes

duration

Call duration of the local user in seconds, represented by an aggregate value.

txBytes

The number of bytes sent.

rxBytes

The number of bytes received.

txAudioBytes

The total number of audio bytes sent, represented by an aggregate value.

txVideoBytes

The total number of video bytes sent, represented by an aggregate value.

rxAudioBytes

The total number of audio bytes received, represented by an aggregate value.

rxVideoBytes

The total number of video bytes received, represented by an aggregate value.

txKBitRate

Video transmission bitrate (Kbps), represented by an instantaneous value.

rxKBitRate

The receiving bitrate (Kbps), represented by an instantaneous value.

rxAudioKBitRate

Audio receive bitrate (Kbps), represented by an instantaneous value.

txAudioKBitRate

The bitrate (Kbps) of sending the audio packet.

rxVideoKBitRate

Video receive bitrate (Kbps), represented by an instantaneous value.

txVideoKBitRate

The bitrate (Kbps) of sending the video.

lastmileDelay

The client-to-server delay (milliseconds).

txPacketLossRate

The packet loss rate (%) from the client to the Agora server before applying the anti-packet-loss algorithm.

rxPacketLossRate

The packet loss rate (%) from the Agora server to the client before using the anti-packet-loss method.

userCount

The number of users in the channel.

cpuAppUsage

The CPU usage (%) of the app.

cpuTotalUsage

The system CPU usage (%).

For Windows, in the multi-kernel environment, this member represents the average CPU usage. The value = 100 - System Idle Progress in Task Manager.

Attention: The value of cpuTotalUsage is always reported as 0 in the OnLeaveChannel callback.

gatewayRtt

The round-trip time delay (ms) from the client to the local router.

memoryAppUsageRatio

The memory ratio occupied by the app (%).

Attention: This value is for reference only. Due to system limitations, you may not get this value.

memoryTotalUsageRatio

The memory occupied by the system (%).

Attention: This value is for reference only. Due to system limitations, you may not get this value.

memoryAppUsageInKbytes

The memory size occupied by the app (KB).

Attention: This value is for reference only. Due to system limitations, you may not get this value.

Attributes

graphicsCardType

Graphics card type, including model information for the graphics card.

errCode

Error code that blocks the window when sharing the screen. See EXCLUDE_WINDOW_ERROR.

Attributes

dimensions

The maximum dimensions of encoding the shared region. For details, see VideoDimensions. The default value is 1,920 × 1,080, that is, 2,073,600 pixels. Agora uses the value of this parameter to calculate the charges.

If the screen dimensions are different from the value of this parameter, Agora applies the following strategies for encoding. Suppose dimensions are set to 1,920 x 1,080:

• If the value of the screen dimensions is lower than that of dimensions, for example, 1,000 x 1,000 pixels, the SDK uses 1,000 x 1,000 pixels for encoding.
• If the value of the screen dimensions is larger than that of dimensions, for example, 2,000 × 1,500, the SDK uses the maximum value next to 1,920 × 1,080 with the aspect ratio of the screen dimension (4:3) for encoding, that is, 1,440 × 1,080.

frameRate

The frame rate (fps) of the shared region. The default value is 5. Agora does not recommend setting it to a value greater than 15.

bitrate

The bitrate (Kbps) of the shared region. The default value is 0, which represents that the SDK works out a bitrate according to the dimensions of the current screen.

captureMouseCursor

Since

v2.4.1

Whether to capture the mouse in screen sharing:

• true: (Default) Capture the mouse.
• false: Do not capture the mouse.

windowFocus

Since

v3.1.0

Whether to bring the window to the front when calling the StartScreenCaptureByWindowId method to share it:

• true:Bring the window to the front.
• false: (Default) Do not bring the window to the front.

excludeWindowList

The ID list of the cpp to be blocked. When calling StartScreenCaptureByScreenRect to start screen sharing, you can use this parameter to block a specified window. When calling UpdateScreenCaptureParameters to update screen sharing configurations, you can use this parameter to dynamically block a specified window.

excludeWindowCount

The number of cpp to be blocked.

Attributes

uid

The user ID of the host.

x

The x coordinate (pixel) of the host's video on the output video frame (taking the upper left corner of the video frame as the origin). The value range is [0, width], where width is the LiveTranscodingwidth set in .

y

The y coordinate (pixel) of the host's video on the output video frame (taking the upper left corner of the video frame as the origin). The value range is [0, height], where height is the LiveTranscodingheight set in .

width

The width (pixel) of the host's video.

height

The height (pixel) of the host's video.

zOrder

The layer index number of the host's video. The value range is [0, 100].

• 0: (Default) The host's video is the bottom layer.
• 100: The host's video is the top layer.

Attention:

• If the value is beyond this range, the SDK reports the error code ERR_INVALID_ARGUMENT.
• As of v2.3, the SDK supports setting zOrder to 0.

alpha

The transparency of the host's video. The value range is [0.0, 1.0].

• 0.0: Completely transparent.
• 1.0: (Default) Opaque.

audioChannel

The audio channel used by the host's audio in the output audio. The default value is 0, and the value range is [0, 5].

• 0: (Recommended) The defaut setting, which supports dual channels at most and depends on the upstream of the host.
• 1: The host's audio uses the FL audio channel. If the host's upstream uses multiple audio channels, the Agora server mixes them into mono first.
• 2: The host's audio uses the FC audio channel. If the host's upstream uses multiple audio channels, the Agora server mixes them into mono first.
• 3: The host's audio uses the FR audio channel. If the host's upstream uses multiple audio channels, the Agora server mixes them into mono first.
• 4: The host's audio uses the BL audio channel. If the host's upstream uses multiple audio channels, the Agora server mixes them into mono first.
• 5: The host's audio uses the BR audio channel. If the host's upstream uses multiple audio channels, the Agora server mixes them into mono first.
• 0xFF or a value greater than 5: The host's audio is muted, and the Agora server removes the host's audio.

Attention: If the value is not 0, a special player is required.

Attributes

uid

User ID

userAccount

The user account. The maximum data length is MAX_USER_ACCOUNT_LENGTH_TYPE.

Attributes

view

The view used to display the video.

renderMode

The rendering mode of the video. See RENDER_MODE_TYPE .

channelId

Since

v3.0.0

The unique channel name in the string format. Supported characters are (89 in total):

• The 26 lowercase English letters: a to z.
• The 26 uppercase English letters: A to Z.
• The 10 numeric characters: 0 to 9.
• Space
• "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", "{", "}", "|", "~", ","

Attention:

• The default value is the empty string "". If the user joins the channel through the JoinChannel [2/2] method of the IAgoraRtcEngine class, set this parameter to the default value. In this case, VideoCanvas sets the user's view in the channel.
• If the user joins the channel using the JoinChannel [2/2] method of the IAgoraRtcChannel class, set this parameter to the channelId of the IAgoraRtcChannel object. In this case, VideoCanvas sets the user's view in the channel corresponding to the channelId .

uid

User ID.

mirrorMode

Since

v3.0.0

The mirror mode of the view. See VIDEO_MIRROR_MODE_TYPE .

Attention:

• For the local user:
  • If the user uses the front camera, the mirror mode is enabled by default.
  • If the user uses the rear camera, the mirror mode is disabled by default.
• For the remote user: The SDK disables the mirror mode by default.

Attributes

level

Video noise reduction level. For details, see VIDEO_DENOISER_LEVEL.

mode

Video noise reduction mode. For details, see VIDEO_DENOISER_MODE.

Attributes

width

The width (pixels) of the video.

height

The height (pixels) of the video.

The video data format is YUV420. Note that the buffer provides a pointer to a pointer. This interface cannot modify the pointer of the buffer but can modify the content of the buffer.

Attributes

type

The type of the video frame. See VIDEO_FRAME_TYPE.

width

Width of the video in the number of pixels.

height

Height of the video in the number of pixels.

yStride

The line span of the Y buffer within the YUV data.

uStride

The line span of the U buffer within the YUV data.

vStride

The line span of the V buffer within the YUV data.

yBuffer

The pointer to the Y buffer pointer within the YUV data.

uBuffer

The pointer to the U buffer pointer within the YUV data.

vBuffer

The pointer to the V buffer pointer within the YUV data.

rotation

Sets the clockwise rotation of the video frame before rendering. Supported values include 0, 90, 180, and 270 degrees.

renderTimeMs

The timestamp (ms) of the external audio frame. It is mandatory. You can use it to restore the order of the captured audio frame, or synchronize audio and video frames in video-related scenarios (including scenarios where external video sources are used).

avsync_type

A reserved parameter.

Attributes

dimensions

The dimensions of the encoded video (px). See VideoDimensions. This parameter measures the video encoding quality in the format of length × width. The default value is 640 × 360. You can set a custom value.

frameRate

The frame rate (fps) of the encoding video frame. The default value is 15.

minFrameRate

The minimum encoding frame rate of the video. The default value is -1.

bitrate

The encoding bitrate (Kbps) of the video.

You can refer to the table below to set the bitrate according to your app scenario. If the bitrate you set is beyond the reasonable range, the SDK sets it within a reasonable range. You can also choose from the following options:

• STANDARD_BITRATE : (Recommended) Standard bitrate mode. In this mode, the video bitrate of the interactive streaming profile is twice that of the communication profile.
• COMPATIBLE_BITRATE: Adaptive bitrate mode. In this mode, the bitrate differs between the interactive streaming and communication profiles. If you choose this mode in the interactive streaming profile, the video frame rate may be lower than the set value.

Agora uses different video codecs for different profiles to optimize user experience. The communication profile prioritizes smoothness while the interactive streaming profile prioritizes video quality (a higher bitrate). Therefore, Agora recommends setting this parameter as STANDARD_BITRATE . You can also set the bitrate value of the Live-broadcasting profile to twice the bitrate value of the communication profile.

Dimensions	Frame rate (fps)	Bitrate (Kbps) for the communication profile	Bitrate (Kbps) for the interactive streaming profile
160 × 120	15	65	130
120 × 120	15	50	100
320 × 180	15	140	280
180 × 180	15	100	200
240 × 180	15	120	240
320 × 240	15	200	400
240 × 240	15	140	280
424 × 240	15	220	440
640 × 360	15	400	800
360 × 360	15	260	520
640 × 360	30	600	1200
360 × 360	30	400	800
480 × 360	15	320	640
480 × 360	30	490	980
640 × 480	15	500	1000
480 × 480	15	400	800
640 × 480	30	750	1500
480 × 480	30	600	1200
848 × 480	15	610	1220
848 × 480	30	930	1860
640 × 480	10	400	800
1280 × 720	15	1130	2260
1280 × 720	30	1710	3420
960 × 720	15	910	1820
960 × 720	30	1380	2760
1920 × 1080	15	2080	4160
1920 × 1080	30	3150	6300
1920 × 1080	60	4780	6500

minBitrate

The minimum encoding bitrate (Kbps) of the video.

The SDK automatically adjusts the encoding bitrate to adapt to the network conditions. Using a value greater than the default value forces the video encoder to output high-quality images but may cause more packet loss and sacrifice the smoothness of the video transmission. Unless you have special requirements for image quality, Agora does not recommend changing this value.

Attention: This parameter only applies to the interactive streaming profile.

orientationMode

The orientation mode of the encoded video. See ORIENTATION_MODE.

degradationPreference

Video degradation preference under limited bandwidth. See DEGRADATION_PREFERENCE.

mirrorMode

Attention: By default, the video is not mirrored.

Attributes

background_source_type

The type of the custom background image. See BACKGROUND_SOURCE_TYPE.

color

The type of the custom background image. The color of the custom background image. The format is a hexadecimal integer defined by RGB, without the # sign, such as 0xFFB6C1 for light pink. The default value is 0xFFFFFF, which signifies white. The value range is [0x000000, 0xffffff]. If the value is invalid, the SDK replaces the original background image with a white background image.

Attention: This parameter takes effect only when the type of the custom background image is BACKGROUND_COLOR.

source

The local absolute path of the custom background image. PNG and JPG formats are supported. If the path is invalid, the SDK replaces the original background image with a white background image.

Attention: This parameter takes effect only when the type of the custom background image is BACKGROUND_IMG.

blur_degree

The degree of blurring applied to the custom background image. See BACKGROUND_BLUR_DEGREE.

Attention: This parameter takes effect only when the type of the custom background image is BACKGROUND_BLUR.

Attributes

visibleInPreview

Whether the watermark image is visible in the local video preview:

• true: (Default) The watermark image is visible in the local preview.
• false: The watermark image is not visible in the local preview.

positionInLandscapeMode

The area to display the watermark image in landscape mode. For details, see Rectangle.

positionInPortraitMode

The area to display the watermark image in portrait mode. For details, see Rectangle.