Skip to main content
Conversational AI Engine: Create advanced voice apps by combining Agora's real-time audio with powerful conversational AI.

In-call quality monitoring

During a call, Video SDK triggers callbacks related to the video calling quality. These callbacks enable you to monitor your users' experience, troubleshoot issues, and optimize their overall experience

Understand the tech​

After a user joins a channel, Video SDK triggers a series of callbacks every 2 seconds, reporting information such as uplink and downlink network quality, real-time interaction statistics, and statistics of local and remote audio and video streams.

When there is a change in the audio or video state of a user, Video SDK triggers a callback to report the latest state and the reason for the change. The following figure shows the audio transmission process between app clients:

Audio transmission process

Audio transmission process

To monitor the call quality, Agora provides the following call quality notifications:

Network quality

The network quality callback provides insight into the uplink and downlink last mile network quality for each participant in the channel. Last mile refers to the network from your device to Agora server. The Network quality scores are calculated based on factors such as sending or receiving bitrate, network packet loss rate, round-trip delay, and network jitter.

Statistics

The statistics callback, triggered every 2 seconds, reports key metrics such as call duration, the number of participants, system CPU usage, and app CPU usage.

Audio quality

Callbacks related to audio quality cover both local and remote audio streams. You monitor statistics and status changes, to gain insights into the quality of audio streams and any related reasons for status changes.

Video quality

Video quality callbacks provide information on both local and remote video streams. You receive statistics and status change notifications, that enable you to understand the quality of video streams and any related reasons for status changes.

Prerequisites​

Ensure that you have implemented the SDK quickstart in your project.

Implement in-call quality monitoring​

In IRtcEngineEventHandler, implement the following real-time interaction quality statistics callbacks and audio or video state monitoring callbacks to understand user interaction experience:

  • onNetworkQuality: Reports uplink and downlink last mile network quality.
  • onRtcStats: Reports real-time interaction statistics.
  • onLocalAudioStats: Reports statistics for the sent audio stream.
  • onLocalAudioStateChanged: Reports local audio stream state changes.
  • onRemoteAudioStats: Reports statistics for the received remote audio stream.
  • onRemoteAudioStateChanged: Reports remote audio stream state changes.
  • onLocalVideoStats: Reports statistics for the sent video stream.
  • onLocalVideoStateChanged: Reports local video stream state changes.
  • onRemoteVideoStats: Reports statistics for the received remote video stream.
  • onRemoteVideoStateChanged: Reports remote video stream state changes.

In your app, add the following code:

// Example implementation in Kotlinprivate val iRtcEngineEventHandler = object : IRtcEngineEventHandler() {    // Implement the onNetworkQuality callback    override fun onNetworkQuality(uid: Int, txQuality: Int, rxQuality: Int) {        Log.i(TAG, "onNetworkQuality-> UID: $uid, TX Quality: $txQuality, RX Quality: $rxQuality")    }    // Implement the onLocalAudioStateChanged callback    override fun onLocalAudioStateChanged(state: Int, error: Int) {        super.onLocalAudioStateChanged(state, error)        Log.i(TAG, "onLocalAudioStateChanged-> State: $state, Error: $error")    }    // Implement the onRemoteAudioStateChanged callback    override fun onRemoteAudioStateChanged(uid: Int, state: Int, reason: Int, elapsed: Int) {        super.onRemoteAudioStateChanged(uid, state, reason, elapsed)        Log.i(TAG, "onRemoteAudioStateChanged-> UID: $uid, State: $state, Reason: $reason, Elapsed: $elapsed")    }    // Implement the onLocalVideoStateChanged callback    override fun onLocalVideoStateChanged(source: Constants.VideoSourceType, state: Int, error: Int) {        super.onLocalVideoStateChanged(source, state, error)        Log.i(TAG, "onLocalVideoStateChanged-> State: $state, Error: $error")    }    // Implement the onRemoteVideoStateChanged callback    override fun onRemoteVideoStateChanged(uid: Int, remoteVideoState: Int, reason: Int, elapsed: Int) {        super.onRemoteVideoStateChanged(uid, remoteVideoState, reason, elapsed)        Log.i(TAG, "onRemoteVideoStateChanged-> UID: $uid, State: $remoteVideoState, Reason: $reason, Elapsed: $elapsed")    }    // Implement the onRemoteAudioStats callback    override fun onRemoteAudioStats(remoteAudioStats: RemoteAudioStats) {        Log.i(TAG, "onRemoteAudioStats-> Received bitrate: ${remoteAudioStats.receivedBitrate}")    }    // Implement the onLocalAudioStats callback    override fun onLocalAudioStats(localAudioStats: LocalAudioStats) {        Log.i(TAG, "onLocalAudioStats-> Network transport delay: ${localAudioStats.networkTransportDelay}")    }    // Implement the onRemoteVideoStats callback    override fun onRemoteVideoStats(remoteVideoStats: RemoteVideoStats) {        Log.i(TAG, "onRemoteVideoStats-> Received bitrate: ${remoteVideoStats.receivedBitrate}")    }    // Implement the onLocalVideoStats callback    override fun onLocalVideoStats(localVideoStats: LocalVideoStats) {        Log.i(TAG, "onLocalVideoStats-> Sent frame rate: ${localVideoStats.sentFrameRate}")        // Log other specific information as needed    }    // Implement the onRtcStats callback    override fun onRtcStats(rtcStats: RtcStats) {        Log.i(TAG, "onRtcStats-> User count: ${rtcStats.userCount}, Packet loss rate: ${rtcStats.rxPacketLossRate}")    }}

Reference​

Network quality score​

ValueEnumerationDescription
0QUALITY_UNKNOWNNetwork quality is unknown.
1QUALITY_EXCELLENTThe network quality is excellent.
2QUALITY_GOODThe network quality is good, but the bitrate may be slightly lower than excellent.
3QUALITY_POORThe network quality is average, and users may experience a slight decrease in call quality.
4QUALITY_BADThe network quality is poor, and users may be unable to maintain smooth calls.
5QUALITY_VBADThe network quality is extremely poor, making it almost impossible to make calls.
6QUALITY_DOWNThe network connection is interrupted, and the user is completely unable to make calls.
8QUALITY_DETECTINGLast-mile network quality detection is in progress.

API reference​