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