API Overview

Agora provides ensured quality of experience (QoE) for worldwide Internet-based voice and video communications through SD-RTN™.

Channel management

Method Description
CreateAgoraRtcEngine Creates one IRtcEngine object.
Initialize Initializes IRtcEngine.
Dispose Releases the IRtcEngine instance.
SetChannelProfile Sets the channel profile.
JoinChannel [1/2] Joins a channel.
JoinChannel [2/2] Joins a channel with media options.
UpdateChannelMediaOptions Updates the channel media options after joining the channel.
LeaveChannel [1/2] Leaves a channel.
LeaveChannel [2/2] Sets channel options and leaves the channel.
PreloadChannel[1/2] Preloads a channel with token, channelId, and uid.
PreloadChannel[2/2] Preloads a channel with token, channelId, and userAccount.
UpdatePreloadChannelToken Updates the wildcard token for preloading channels.
RenewToken Renews the token.
SetClientRole [1/2] Sets the client role.
SetClientRole [2/2] Sets the user role and level in an interactive live streaming channel.
GetConnectionState Gets the current connection state of the SDK.

Channel events

Event Description
OnJoinChannelSuccess Occurs when a user joins a channel.
OnRejoinChannelSuccess Occurs when a user rejoins the channel.
OnClientRoleChanged Occurs when the user role switches during the interactive live streaming.
OnClientRoleChangeFailed Occurs when the user role switching fails in the interactive live streaming.
OnLeaveChannel Occurs when a user leaves a channel.
OnUserJoined Occurs when a remote user (in the communication profile)/ host (in the live streaming profile) joins the channel.
OnUserOffline Occurs when a remote user (in the communication profile)/ host (in the live streaming profile) leaves the channel.
OnNetworkTypeChanged Occurs when the local network type changes.
OnUplinkNetworkInfoUpdated Occurs when the uplink network information changes.
OnConnectionLost Occurs when the SDK cannot reconnect to Agora's edge server 10 seconds after its connection to the server is interrupted.
OnConnectionStateChanged Occurs when the network connection state changes.
OnRequestToken Occurs when the token expires.
OnTokenPrivilegeWillExpire Occurs when the token expires in 30 seconds.
OnError Reports an error during SDK runtime.

Audio management

Method Description
EnableAudio Enables the audio module.
DisableAudio Disables the audio module.
SetAudioProfile [2/2] Sets the audio parameters and application scenarios.
SetAudioScenario Sets audio scenarios.
SetAudioSessionOperationRestriction Sets the operational permission of the SDK on the audio session.
AdjustRecordingSignalVolume Adjusts the capturing signal volume.
AdjustUserPlaybackSignalVolume Adjusts the playback signal volume of a specified remote user.
AdjustPlaybackSignalVolume Adjusts the playback signal volume of all remote users.
AdjustLoopbackSignalVolume Adjusts the volume of the signal captured by the sound card.
AdjustCustomAudioPublishVolume Adjusts the volume of the custom audio track played remotely.
MuteRecordingSignal Whether to mute the recording signal.
EnableLocalAudio Enables or disables the local audio capture.
GetAudioDeviceInfo Gets the audio device information.

Video management

Method Description
EnableVideo Enables the video module.
DisableVideo Disables the video module.
SetRenderMode Sets the render mode of the media player.
SetView Sets the view.
SetForUser Sets the local or remote video display.
SetVideoEncoderConfiguration Sets the video encoder configuration.
StartPreview [1/2] Enables the local video preview.
StopPreview [1/2] Stops the local video preview.
StartPreview [2/2] Enables the local video preview and specifies the video source for the preview.
StopPreview [2/2] Stops the local video preview.
SetLocalRenderMode [2/2] Updates the display mode of the local video view.
SetRemoteRenderMode Updates the display mode of the video view of a remote user.
EnableLocalVideo Enables/Disables the local video capture.
MuteLocalVideoStream Stops or resumes publishing the local video stream.
MuteRemoteVideoStream Stops or resumes subscribing to the video stream of a specified user.
MuteAllRemoteVideoStreams Stops or resumes subscribing to the video streams of all remote users.
EnableInstantMediaRendering Enables audio and video frame instant rendering.
StartMediaRenderingTracing Enables tracing the video frame rendering process.
SetVideoScenario Sets video application scenarios.
Event Description
OnVideoRenderingTracingResult Video frame rendering event callback.

Capture screenshots

Method Description
TakeSnapshot Takes a snapshot of a video stream.
Event Description
OnSnapshotTaken Reports the result of taking a video snapshot.

Subscribing to and publishing audio and video streams

Method Description
SetSubscribeAudioBlocklist Set the blocklist of subscriptions for audio streams.
SetSubscribeAudioAllowlist Sets the allowlist of subscriptions for audio streams.
SetSubscribeVideoBlocklist Set the blocklist of subscriptions for video streams.
SetSubscribeVideoAllowlist Set the allowlist of subscriptions for video streams.
MuteLocalAudioStream Stops or resumes publishing the local audio stream.
MuteRemoteAudioStream Stops or resumes subscribing to the audio stream of a specified user.
MuteAllRemoteAudioStreams Stops or resumes subscribing to the audio streams of all remote users.
EnableLocalVideo Enables/Disables the local video capture.
MuteLocalVideoStream Stops or resumes publishing the local video stream.
MuteRemoteVideoStream Stops or resumes subscribing to the video stream of a specified user.
MuteAllRemoteVideoStreams Stops or resumes subscribing to the video streams of all remote users.
SetRemoteVideoSubscriptionOptions Options for subscribing to remote video streams.

Media player

For more methods about the media player, see IMediaPlayer.

Method Description
CreateMediaPlayer Creates a media player instance.
Dispose Releases all the resources occupied by the media player.
GetMediaPlayerCacheManager Gets one IMediaPlayerCacheManager instance.
IMediaPlayer This class provides media player functions and supports multiple instances.
IMediaPlayerCacheManager This class provides methods to manage cached media files.
IMediaPlayerSourceObserver Provides callbacks for media players.

Directly pushing streams to the CDN

Method Description
StartDirectCdnStreaming Starts pushing media streams to the CDN directly.
StopDirectCdnStreaming Stops pushing media streams to the CDN directly.
SetDirectCdnStreamingAudioConfiguration Sets the audio profile of the audio streams directly pushed to the CDN by the host.
SetDirectCdnStreamingVideoConfiguration Sets the video profile of the media streams directly pushed to the CDN by the host.
Event Description
OnDirectCdnStreamingStateChanged Occurs when the CDN streaming state changes.
OnDirectCdnStreamingStats Reports the CDN streaming statistics.

Local media events

Event Description
OnLocalAudioStateChanged Occurs when the local audio stream state changes.
OnLocalVideoStateChanged Occurs when the local video stream state changes.
OnFirstLocalAudioFramePublished Occurs when the first audio frame is published.
OnFirstLocalVideoFramePublished Occurs when the first video frame is published.
OnAudioPublishStateChanged Occurs when the audio publishing state changes.
OnVideoPublishStateChanged Occurs when the video publishing state changes.

Remote media events

Event Description
OnRemoteAudioStateChanged Occurs when the remote audio state changes.
OnRemoteVideoStateChanged Occurs when the remote video stream state changes.
OnFirstRemoteAudioFrame Occurs when the SDK receives the first audio frame from a specific remote user.
OnFirstRemoteVideoFrame Occurs when the renderer receives the first frame of the remote video.
OnFirstRemoteVideoDecoded Occurs when the first remote video frame is received and decoded.
OnAudioSubscribeStateChanged Occurs when the audio subscribing state changes.
OnVideoSubscribeStateChanged Occurs when the video subscribing state changes.
OnUserMuteAudio Occurs when a remote user (in the communication profile) or a host (in the live streaming profile) stops/resumes sending the audio stream.
OnUserMuteVideo Occurs when a remote user stops or resumes publishing the video stream.
OnUserEnableVideo Occurs when a remote user enables or disables the video module.
OnUserEnableLocalVideo Occurs when a specific remote user enables/disables the local video capturing function.

Statistics events

Event Description
OnRtcStats Reports the statistics of the current call.
OnNetworkQuality Reports the last mile network quality of each user in the channel.
OnLocalAudioStats Reports the statistics of the local audio stream.
OnLocalVideoStats Reports the statistics of the local video stream.
OnRemoteAudioStats Reports the transport-layer statistics of each remote audio stream.
OnRemoteVideoStats Reports the statistics of the video stream sent by each remote users.

Audio pre-process and post-process

Method Description
SetAdvancedAudioOptions Sets audio advanced options.
SetAINSMode Sets whether to enable the AI ​​noise suppression function and set the noise suppression mode.

Video pre-process and post-process

Method Description
SetBeautyEffectOptions Sets the image enhancement options.
EnableVirtualBackground Enables/Disables the virtual background.
SetColorEnhanceOptions Sets color enhancement.
SetLowlightEnhanceOptions Sets low-light enhancement.
SetVideoDenoiserOptions Sets video noise reduction.

Face detection

Note: This group of methods is for Android and iOS only.
Method Description
EnableFaceDetection Enables or disables face detection for the local user.
Event Description
OnFacePositionChanged Reports the face detection result of the local user.

In-ear monitoring

Method Description
EnableInEarMonitoring Enables in-ear monitoring.
SetInEarMonitoringVolume Sets the volume of the in-ear monitor.
SetEarMonitoringAudioFrameParameters Sets the format of the in-ear monitoring raw audio data.
Event Description
OnEarMonitoringAudioFrame Gets the in-ear monitoring audio frame.

Music file playback and mixing

Method Description
StartAudioMixing [1/2] Starts playing the music file.
StartAudioMixing [2/2] Starts playing the music file.
StopAudioMixing Stops playing and mixing the music file.
PauseAudioMixing Pauses playing and mixing the music file.
ResumeAudioMixing Resumes playing and mixing the music file.
AdjustAudioMixingVolume Adjusts the volume during audio mixing.
AdjustAudioMixingPlayoutVolume Adjusts the volume of audio mixing for local playback.
AdjustAudioMixingPublishVolume Adjusts the volume of audio mixing for publishing.
GetAudioMixingPlayoutVolume Retrieves the audio mixing volume for local playback.
GetAudioMixingPublishVolume Retrieves the audio mixing volume for publishing.
GetAudioMixingDuration Retrieves the duration (ms) of the music file.
GetAudioMixingCurrentPosition Retrieves the playback position (ms) of the music file.
SetAudioMixingPitch Sets the pitch of the local music file.
SetAudioMixingPosition Sets the audio mixing position.
SetAudioMixingDualMonoMode Sets the channel mode of the current audio file.
Event Description
OnAudioMixingStateChanged Occurs when the playback state of the music file changes.
OnAudioMixingPositionChanged Reports the playback progress of a music file.

Audio effect file playback

Method Description
GetEffectsVolume Retrieves the volume of the audio effects.
SetEffectsVolume Sets the volume of the audio effects.
GetVolumeOfEffect Gets the volume of a specified audio effect file.
SetVolumeOfEffect Sets the volume of a specified audio effect.
PreloadEffect Preloads a specified audio effect file into the memory.
PlayEffect Plays the specified local or online audio effect file.
PlayAllEffects Plays all audio effect files.
PauseEffect Pauses a specified audio effect file.
PauseAllEffects Pauses all audio effects.
ResumeEffect Resumes playing a specified audio effect.
ResumeAllEffects Resumes playing all audio effect files.
StopEffect Stops playing a specified audio effect.
StopAllEffects Stops playing all audio effects.
UnloadEffect Releases a specified preloaded audio effect from the memory.
UnloadAllEffects Releases a specified preloaded audio effect from the memory.
GetEffectDuration Retrieves the duration of the audio effect file.
GetEffectCurrentPosition Retrieves the playback position of the audio effect file.
SetEffectPosition Sets the playback position of an audio effect file.

Virtual metronome

Note:

This group of methods is for Android and iOS only.

Method Description
StartRhythmPlayer Enables the virtual metronome.
StopRhythmPlayer Disables the virtual metronome.
ConfigRhythmPlayer Configures the virtual metronome.
Event Description
OnRhythmPlayerStateChanged Occurs when the state of virtual metronome changes.

Voice changer and reverberation

Method Description
SetLocalVoiceEqualization Sets the local voice equalization effect.
SetLocalVoicePitch Changes the voice pitch of the local speaker.
SetLocalVoiceReverb Sets the local voice reverberation.
SetVoiceBeautifierPreset Sets a preset voice beautifier effect.
SetVoiceBeautifierParameters Sets parameters for the preset voice beautifier effects.
SetAudioEffectPreset Sets an SDK preset audio effect.
SetAudioEffectParameters Sets parameters for SDK preset audio effects.
SetVoiceConversionPreset Sets a preset voice beautifier effect.
SetLocalVoiceFormant Set the formant ratio to change the timbre of human voice.

Pre-call network test

Method Description
StartEchoTest [1/3] Starts an audio call test.
StartEchoTest [2/3] Starts an audio call test.
StartEchoTest [3/3] Starts an audio device loopback test.
StopEchoTest Stops the audio call test.
StartLastmileProbeTest Starts the last mile network probe test.
StopLastmileProbeTest Stops the last mile network probe test.
Event Description
OnLastmileQuality Reports the last-mile network quality of the local user.
OnLastmileProbeResult Reports the last mile network probe result.

Screen Sharing

Method Description
GetScreenCaptureSources Gets a list of shareable screens and windows. (For Windows and macOS only)
StartScreenCaptureByWindowId Captures the whole or part of a window by specifying the window ID. (For Windows and macOS only)
StartScreenCaptureByScreenRect Captures the whole or part of a screen by specifying the screen rect. (For Windows only)
StartScreenCaptureByDisplayId Captures the screen by specifying the display ID. (For Windows and macOS only)
SetScreenCaptureContentHint Sets the content hint for screen sharing. (For Windows and macOS only)
UpdateScreenCaptureRegion Updates the screen capturing region. (For Windows and macOS only)
QueryScreenCaptureCapability Queries the highest frame rate supported by the device during screen sharing.(For Android and iOS only)
StartScreenCapture [1/2] Starts screen capture.(For Android and iOS only)
StartScreenCapture [2/2] Starts screen capture. (For Windows and macOS only)
UpdateScreenCapture Updates the screen capturing parameters.(For Android and iOS only)
UpdateScreenCaptureParameters Updates the screen capturing parameters. (For Windows and macOS only)
StopScreenCapture [1/2] Stops screen capture.
StopScreenCapture [2/2] Stops screen capture. (For Windows and macOS only)
SetScreenCaptureScenario Sets the screen sharing scenario. (For Windows and macOS only)

Video dual stream

Method Description
SetRemoteVideoStreamType Sets the stream type of the remote video.
SetRemoteDefaultVideoStreamType Sets the default stream type of subscrption for remote video streams.
SetDualStreamMode [2/2] Sets dual-stream mode configuration on the sender, and sets the low-quality video stream.

Watermark

Method Description
AddVideoWatermark [2/2] Adds a watermark image to the local video.
ClearVideoWatermarks Removes the watermark image from the video stream.

Encryption

Method Description
EnableEncryption Enables or disables the built-in encryption.
Event Description
OnEncryptionError Reports the built-in encryption errors.

Sound localization

Method Description
EnableSoundPositionIndication Enables or disables stereo panning for remote users.
SetRemoteVoicePosition Sets the 2D position (the position on the horizontal plane) of the remote user's voice.

Spatial audio effect

Local Cartesian coordinate system calculation solution Description
GetLocalSpatialAudioEngine Gets one ILocalSpatialAudioEngine object.
Initialize Initializes ILocalSpatialAudioEngine.
Dispose Destroys ILocalSpatialAudioEngine.
UpdateSelfPosition Updates the spatial position of the local user.
UpdateRemotePosition Updates the spatial position of the specified remote user.
RemoveRemotePosition Removes the spatial position of the specified remote user.
ClearRemotePositions Removes the spatial positions of all remote users.

Media push

Method Description
StartRtmpStreamWithoutTranscoding Starts pushing media streams to a CDN without transcoding.
StartRtmpStreamWithTranscoding Starts Media Push and sets the transcoding configuration.
UpdateRtmpTranscoding Updates the transcoding configuration.
StopRtmpStream Stops pushing media streams to a CDN.
Event Description
OnRtmpStreamingEvent Reports events during the Media Push.
OnRtmpStreamingStateChanged Occurs when the state of Media Push changes.
OnTranscodingUpdated Occurs when the publisher's transcoding is updated.

Local video transcoder

Method Description
StartLocalVideoTranscoder Starts the local video mixing.
StopLocalVideoTranscoder Stops the local video mixing.
UpdateLocalTranscoderConfiguration Updates the local video mixing configuration.
Event Description
OnLocalVideoTranscoderError Occurs when there's an error during the local video mixing.

Channel media stream relay

Method Description
StartChannelMediaRelay Starts relaying media streams across channels. This method can be used to implement scenarios such as co-host across channels.
UpdateChannelMediaRelay Updates the channels for media stream relay.
StartOrUpdateChannelMediaRelay Starts relaying media streams across channels or updates channels for media relay.
StopChannelMediaRelay Stops the media stream relay. Once the relay stops, the host quits all the target channels.
PauseAllChannelMediaRelay Pauses the media stream relay to all target channels.
ResumeAllChannelMediaRelay Resumes the media stream relay to all target channels.
Event Description
OnChannelMediaRelayStateChanged Occurs when the state of the media stream relay changes.
OnChannelMediaRelayEvent Reports events during the media stream relay.

Custom audio source

Method Description
CreateCustomAudioTrack Creates a custom audio track.
DestroyCustomAudioTrack Destroys the specified audio track.
SetExternalAudioSource Sets the external audio source parameters.
PushAudioFrame Pushes the external audio frame.

Custom audio renderer

Method Description
SetExternalAudioSink Sets the external audio sink.
PullAudioFrame Pulls the remote audio data.

Raw audio data

Method Description
RegisterAudioFrameObserver Registers an audio frame observer object.
SetRecordingAudioFrameParameters Sets the format of the captured raw audio data.
SetPlaybackAudioFrameParameters Sets the audio data format for playback.
SetMixedAudioFrameParameters Sets the audio data format reported by OnMixedAudioFrame.
SetPlaybackAudioFrameBeforeMixingParameters Sets the audio data format reported by OnPlaybackAudioFrameBeforeMixing.
Event Description
OnRecordAudioFrame Gets the captured audio frame.
OnPlaybackAudioFrame Gets the raw audio frame for playback.
OnPlaybackAudioFrameBeforeMixing Retrieves the audio frame of a specified user before mixing.
OnMixedAudioFrame Retrieves the mixed captured and playback audio frame.

Encoded audio data

Method Description
RegisterAudioEncodedFrameObserver Registers an encoded audio observer.
Event Description
OnRecordAudioEncodedFrame Gets the encoded audio data of the local user.
OnPlaybackAudioEncodedFrame Gets the encoded audio data of all remote users.
OnMixedAudioEncodedFrame Gets the mixed and encoded audio data of the local and all remote users.

Audio spectrum

Method Description
RegisterAudioSpectrumObserver Register an audio spectrum observer.
EnableAudioSpectrumMonitor Turns on audio spectrum monitoring.
DisableAudioSpectrumMonitor Disables audio spectrum monitoring.
UnregisterAudioSpectrumObserver Unregisters the audio spectrum observer.
Event Description
OnLocalAudioSpectrum Gets the statistics of a local audio spectrum.
OnRemoteAudioSpectrum Gets the remote audio spectrum.

Custom video source

Method Description
CreateCustomVideoTrack Creates a customized video track.
DestroyCustomVideoTrack Destroys the specified video track.

External video source

Method Description
SetExternalVideoSource Configures the external video source.
PushVideoFrame Pushes the external raw video frame to the SDK.

Raw video data

Method Description
RegisterVideoFrameObserver Registers a raw video frame observer object.
Event Description
OnCaptureVideoFrame Occurs each time the SDK receives a video frame captured by local devices.
OnPreEncodeVideoFrame Occurs each time the SDK receives a video frame before encoding.
OnRenderVideoFrame Occurs each time the SDK receives a video frame sent by the remote user.

Encoded video data

Method Description
RegisterVideoEncodedFrameObserver Registers a receiver object for the encoded video image.
Event Description
OnEncodedVideoFrameReceived Reports that the receiver has received the to-be-decoded video frame sent by the remote end.

Extension

Method Description
EnableExtension Enables or disables extensions.
SetExtensionProperty Sets the properties of the extension.
SetExtensionProviderProperty Sets the properties of the extension provider.
GetExtensionProperty Gets detailed information on the extensions.
RegisterExtension Registers an extension. (For Windows only)
Event Description
OnExtensionEvent The event callback of the extension.
OnExtensionStarted Occurs when the extension is enabled.
OnExtensionStopped Occurs when the extension is disabled.

Media metadata

Method Description
RegisterMediaMetadataObserver Registers the metadata observer.
UnregisterMediaMetadataObserver Unregisters the specified metadata observer.
SetMaxMetadataSize Sets the maximum size of the media metadata.
SendMetaData Sends media metadata.
Event Description
OnMetadataReceived Occurs when the local user receives the metadata.

Audio recording

Method Description
StartAudioRecording [3/3] Starts audio recording on the client and sets recording configurations.
StopAudioRecording Stops the audio recording on the client.

Camera management

Method Description
EnableMultiCamera Enables or disables multi-camera capture.(For iOS only)
SwitchCamera Switches between front and rear cameras.(For Android and iOS only)
SetCameraDeviceOrientation Sets the rotation angle of the captured video. (For Windows only)
SetCameraCapturerConfiguration Sets the camera capture configuration.
StartCameraCapture Starts camera capture.
StopCameraCapture Stops camera capture.
IsCameraZoomSupported Checks whether the device supports camera zoom.(For Android and iOS only)
GetCameraMaxZoomFactor Gets the maximum zoom ratio supported by the camera.(For Android and iOS only)
SetCameraZoomFactor Sets the camera zoom ratio.(For Android and iOS only)
IsCameraTorchSupported Checks whether the device supports camera flash.(For Android and iOS only)
SetCameraTorchOn Enables the camera flash.(For Android and iOS only)
IsCameraFaceDetectSupported Checks whether the device camera supports face detection.(For Android and iOS only)
IsCameraFocusSupported Check whether the device supports the manual focus function.(For Android and iOS only)
SetCameraFocusPositionInPreview Sets the camera manual focus position.(For Android and iOS only)
IsCameraAutoFocusFaceModeSupported Checks whether the device supports the face auto-focus function.(For Android and iOS only)
SetCameraAutoFocusFaceModeEnabled Enables the camera auto-face focus function.(For Android and iOS only)
IsCameraExposurePositionSupported Checks whether the device supports manual exposure.(For Android and iOS only)
IsCameraExposureSupported Queries whether the current camera supports adjusting exposure value.(For Android and iOS only)
IsCameraAutoExposureFaceModeSupported Checks whether the device supports auto exposure.(For iOS only)
SetCameraExposurePosition Sets the camera exposure position.(For Android and iOS only)
SetCameraExposureFactor Sets the camera exposure value.(For Android and iOS only)
SetCameraAutoExposureFaceModeEnabled Sets whether to enable auto exposure.(For iOS only)
Event Description
OnCameraFocusAreaChanged Occurs when the camera focus area changes.(For Android and iOS only)
OnCameraExposureAreaChanged Occurs when the camera exposure area changes.(For Android and iOS only)

Multiple channels

For more methods about multi-channel, see IRtcEngineEx.

Method Description
CreateAgoraRtcEngineEx Creates one IRtcEngineEx object.
JoinChannelEx Joins a channel with the connection ID.
LeaveChannelEx [2/2] Sets channel options and leaves the channel.

Audio route

Method Description
SetDefaultAudioRouteToSpeakerphone Sets the default audio playback route.
SetEnableSpeakerphone Enables/Disables the audio route to the speakerphone.
SetRouteInCommunicationMode Selects the audio playback route in communication audio mode.
Event Description
OnAudioRoutingChanged Occurs when the local audio route changes.

Volume indication

Method Description
EnableAudioVolumeIndication Enables the reporting of users' volume indication.
Event Description
OnAudioVolumeIndication Reports the volume information of users.
OnActiveSpeaker Occurs when the most active remote speaker is detected.

Data stream

Method Description
CreateDataStream [2/2] Creates a data stream.
SendStreamMessage Sends data stream messages.
Event Description
OnStreamMessage Occurs when the local user receives the data stream from the remote user.
OnStreamMessageError Occurs when the local user does not receive the data stream from the remote user.

Video Device Management

Method Description
EnumerateVideoDevices Enumerates the video devices. (For Windows and macOS only)
SetDevice Specifies the video capture device with the device ID. (For Windows and macOS only)
GetDevice Retrieves the current video capture device. (For Windows and macOS only)
NumberOfCapabilities Gets the number of video formats supported by the specified video capture device. (For Windows and macOS only)
GetCapability Gets the detailed video frame information of the video capture device in the specified video format. (For Windows and macOS only)
QueryCodecCapability Queries the current device's supported video codec capabilities.
Event Description
OnVideoDeviceStateChanged Occurs when the video device state changes. (For Windows and macOS only)

Audio Device Management

Method Description
EnumeratePlaybackDevices Enumerates the audio playback devices. (For Windows and macOS only)
EnumerateRecordingDevices Enumerates the audio capture devices. (For Windows and macOS only)
FollowSystemPlaybackDevice Sets the audio playback device used by the SDK to follow the system default audio playback device. (For Windows and macOS only)
FollowSystemRecordingDevice Sets the audio recording device used by the SDK to follow the system default audio recording device. (For Windows and macOS only)
SetPlaybackDevice Sets the audio playback device. (For Windows and macOS only)
GetPlaybackDevice Retrieves the audio playback device associated with the device ID. (For Windows and macOS only)
GetPlaybackDeviceInfo Retrieves the audio playback device associated with the device ID. (For Windows and macOS only)
SetLoopbackDevice Sets the loopback device. (For Windows and macOS only)
GetLoopbackDevice Gets the current loopback device. (For Windows and macOS only)
FollowSystemLoopbackDevice Sets whether the loopback device follows the system default playback device. (For Windows and macOS only)
SetRecordingDevice Sets the audio capture device. (For Windows and macOS only)
GetRecordingDevice Gets the current audio recording device. (For Windows and macOS only)
GetRecordingDeviceInfo Retrieves the volume of the audio recording device. (For Windows and macOS only)
SetRecordingDeviceVolume Sets the volume of the audio capture device. (For Windows and macOS only)
StartPlaybackDeviceTest Starts the audio playback device test. (For Windows and macOS only)
StopPlaybackDeviceTest Stops the audio playback device test. (For Windows and macOS only)
StartRecordingDeviceTest Starts the audio capture device test. (For Windows and macOS only)
StopRecordingDeviceTest Stops the audio capture device test. (For Windows and macOS only)
StartAudioDeviceLoopbackTest Starts an audio device loopback test. (For Windows and macOS only)
StopAudioDeviceLoopbackTest Stops the audio device loopback test. (For Windows and macOS only)
Event Description
OnAudioDeviceStateChanged Occurs when the audio device state changes. (For Windows and macOS only)
OnAudioDeviceVolumeChanged Reports the volume change of the audio device or app.

Miscellaneous audio control

Note:

This group of methods is for Windows and macOS only.

Method Description
EnableLoopbackRecording Enables loopback audio capturing.

Miscellaneous methods

Method Description
GetCurrentMonotonicTimeInMs Gets the current Monotonic Time of the SDK.
SetCloudProxy Sets up cloud proxy service.
SetEnable Sets whether to enable the video rendering.
SetParameters [1/2] Provides technical preview functionalities or special customizations by configuring the SDK with JSON options.
GetCallId Retrieves the call ID.
Rate Allows a user to rate a call after the call ends.
Complain Allows a user to complain about the call quality after a call ends.
GetVersion Gets the SDK version.
GetErrorDescription Gets the warning or error description.
EnableVideoImageSource Sets whether to replace the current video feeds with images when publishing video streams.
GetNetworkType Gets the type of the local network connection.
GetNtpWallTimeInMs Gets the current NTP (Network Time Protocol) time.
SetHeadphoneEQPreset Sets the preset headphone equalization effect.
SetHeadphoneEQParameters Sets the low- and high-frequency parameters of the headphone equalizer.

Miscellaneous events

Event Description
OnProxyConnected Reports the proxy connection state.