Report In-call Statistics

After joining the channel, the SDK triggers the following callbacks related to the call quality once every two seconds. You can see the last mile network quality, local statistics, audio quality, and video quality of the current call.

Ensure that you implement a video call or interactive video streaming in your project. For details, see Start a Video Call or Start Live Interactive Video Streaming.

The OnNetworkQualityHandler callback reports the uplink and downlink last mile network quality of each user/host in the current call, see Quality Rating for details. Last mile refers to the network from your device to Agora’s edge server. The uplink last mile quality rating is based on the actual transmission bitrate, the uplink network packet loss rate, the average round-trip delay, and the uplink network jitter; while the downlink last mile quality rating is based on the downlink network packet loss rate, the average round-trip delay, and the downlink network jitter.

In the COMMUNICATION profile, you receive network quality reports of all the users (including yours) in the channel once every two seconds.

In the LIVE_BROADCASTING profile, if you are the host, you receive network quality reports of all hosts (including yours) in the channel once every two seconds; if you are the audience, you receive the report of all hosts and yourself once every two seconds.

The higher the ratio of the actual transmission bitrate to the target transmission bitrate, the better the call quality and the higher the network quality.

The average round-trip delay refers to the average value of multiple round-trip delays in the reported interval.

The OnRtcStatsHandler callback reports call statistics. You can see the duration, the number of users in the channel, the system CPU usage, the application CPU usage, and the following parameters of the current call.

Parameter	Description	Comment
txBytes/rxBytes	The total number of bytes sent/received.	The number of bytes accumulated since joining the channel.
txAudioBytes/rxAudioByte	The total number of audio bytes sent/received.	The number of bytes accumulated since joining the channel.
txVideoBytes/rxVideoBytes	The total number of video bytes sent/received.	The number of bytes accumulated since joining the channel.
txKBitRate/rxKBitRate	The bitrate sent/received.	The actual bitrate sent/received in the reported interval.
txAudioKBitRate/rxAudioKBitRate	The bitrate sent/received of the audio packet.	The actual bitrate sent/received in the reported interval.
txVideoKBitRate/rxVideoKBitRate	The bitrate sent/received of the video packet.	The actual bitrate sent/received in the reported interval.
lastmileDelay	The network delay from the local client to Agora’s edge server.	This refers to half of the average round-trip delay, and not the one-way network delay from the client to Agora’s edge server or vice versa. The network delay here does not distinguish between the audio and video delay, and is the data obtained by the UDP packet.
txPacketLossRate	The packet loss rate from the local client to Agora’s edge server.	The larger value between audio’s and video’s uplink packet loss rate. The packet loss rate before using the anti-packet-loss method.
rxPacketLossRate	The packet loss rate from Agora’s edge server to the local client.	The larger value between audio’s and video’s downlink packet loss rate. The packet loss rate before using the anti-packet-loss method.

The OnLocalAudioStatsHandler callback reports the statistics of the audio streams sent. You can see the number of channels (mono or dual), the sample rate, and the average sending bitrate in the reported interval.

The SDK triggers this callback once every two seconds. The sample rate refers to the actual sample rate of the audio streams sent in the reported interval.

When the state of the local audio stream changes (including the state of the audio recording and encoding), the SDK triggers the OnLocalAudioStateChangedHandler callback to report the current state. You can troubleshoot with the error code when exceptions occur.

The OnRemoteAudioStatsHandler callback reports the audio statistics of each remote user/host in the current call. You can see the quality of the audio stream sent by each remote user/host (see Quality Rating, the number of channels (mono or dual), and the following parameters.

Parameter	Description	Comment
networkTransportDelay	The network delay from the sender to the receiver.	Stages 2 + 3 + 4 in the figure above
jitterBufferDelay	The network delay from the receiver to the network jitter buffer.	Stage 5 in the figure above
audioLossRate	The frame loss rate of the received remote audio streams in the reported interval.	Stages 2 + 3 + 4 + 5 in the figure above In a reported interval, audio freeze occurs when the audio frame loss rate reaches 4%.
receivedSampleRate	The sample rate of the received remote audio streams in the reported interval.
receivedBitrate	The average bitrate of the received remote audio streams in the reported interval.
totalFrozenTime	The total freeze time (ms) of the remote audio streams after the remote user joins the channel.	Agora defines totalFrozenTime = The number of times the audio freezes × 2 × 1000 (ms). The total time is the cumulative duration after the remote user joins the channel.
frozenRate	The total audio freeze time is a percentage of the total time when the audio is available.	When the remote user/host neither stops sending the audio stream nordisables the audio module after joining the channel, the audio is available.

The OnRemoteAudioStatsHandler callback reports statistics more closely linked to the real-user experience of the audio transmission quality. Even if network packet loss occurs, users may find the overall audio quality acceptable because the audio frame loss rate of the received audio streams may not be high due to the anti-packet-loss and congestion control methods, such as forward error correction (FEC), retransmissions and bandwidth estimation.

In the COMMUNICATION profile, you receive the audio stream statistics of all the remote users (excluding yours) in the channel once every two seconds.

In the LIVE_BROADCASTING profile, if you are the host, you receive the audio stream statistics of all remote hosts (excluding yours) in the channel once every two seconds; if you are the audience, you receive the statistics of all hosts in the channel once every two seconds.

Agora's audio module refers to the audio processing process, and not the actual module in the SDK. When sending audio streams, the audio module refers to the processes of audio sampling, pre-processing, and encoding; when receiving audio streams, the audio module refers to the processes of audio decoding, post-processing, and playback.

Users can only turn on/off their own audio modules.

By default, the audio freezes at most once in each reported interval.

When the state of remote audio stream changes, the SDK triggers the OnRemoteAudioStateChangedHandler callback to report the current state and the reason for the state change.

In the COMMUNICATION profile, this callback reports to you the audio stream state information of all the remote users (excluding yours) in the channel once every two seconds.

In the LIVE_BROADCASTING profile, if you are the host, this callback reports to you the audio stream state information of all the remote hosts(excluding yours) in the channel once every two seconds; if you are the audience, this callback reports to you the audio stream state information of all the remote hosts in the channel once every two seconds.

The OnLocalVideoStatsHandler callback reports the statistics of the video streams sent. You can see the dimensions of the encoding frame and the following parameters.

Parameter	Description	Comment
rendererOutputFrameRate	The output frame rate of the local video renderer.
encoderOutputFrameRate	The output frame rate of the local video encoder.
targetBitrate	The target bitrate of the current encoder.	This value is estimated by the SDK based on current network conditions.
targetFrameRate	The target frame rate of the current encoder.
encodedBitrate	The bitrate of the encoding video.	Does not include the bitrate of the retransmission videos.
sentBitrate	The bitrate of the video sent in the reported interval.	Does not include the bitrate of the retransmission videos.
sentFrameRate	The frame rate of the video sent in the reported interval.	Does not include the frame rate of the retransmission videos.
encodedFrameCount	The total frames of the video sent.	The number of frames accumulated since joining the channel.
codecType	The codec type of the local video.	VIDEO_CODEC_VP8 = 1: VP8 VIDEO_CODEC_H264 = 2: (Default) H.264
qualityAdaptIndication	The local video quality change in terms of targetBitrate and targetFrameRate in thisreported interval.	Compared to the video quality in the last statistics (two seconds ago), the video quality change in this reported interval: The quality stays the same. The quality improves. The quality deteriorates.

When the state of the local video changes, the SDK triggers the OnLocalVideoStateChangedHandler callback to report the current state. You can troubleshoot with the error code when exceptions occur.

The OnRemoteVideoStatsHandler callback reports the video statistics of each remote user/host in the current call. You can see their video dimensions and the following parameters.

Parameter	Description	Comment
rxStreamType	The type of video streams.	High-video streams or low-video streams.
receivedBitrate	The bitrate of the video received in the reported interval.
packetLossRate	The packet loss rate of the video received in the reported interval.	Stages 2 + 3 + 4 in the figure above The packet loss rate after using the anti-packet-loss method, which is lower than before.
decoderOutputFrameRate	The output frame rate of the remote video decoder.
rendererOutputFrameRate	The output frame rate of the remote video renderer.
totalFrozenTime	The total freeze time (ms) of the remote video stream after the remote user joins the channel.	In a video call or interactive live video streaming session where the frame rate is set to no less than 5 fps, video freeze occurs when the time interval between two adjacent renderable video frames is more than 500 ms.
frozenRate	The total video freeze time is a percentage of the total time when the video is available.	When the remote user/host neither stops sending the video stream nor disables the video module after joining the channel, the video is available.

In the COMMUNICATION profile, you receive video stream statistics of all the remote users (excluding yours) in the channel once every two seconds.

In the LIVE_BROADCASTING profile, if you are the host, you receive video stream statistics of all the remote hosts (excluding yours) in the channel once every two seconds; if you are the audience, you receive the statistics for all the hosts in the channel once every two seconds.

Agora’s video module refers to the video processing process, and not the actual module in the SDK. When sending video streams, the video module refers to the processes of video capturing, pre-processing, and encoding; when receiving video streams, the video module refers to the processes of video decoding, post-processing, and rendering/playing.

Users can only turn on/off their own video modules.

When the state of remote video streams changes, the SDK triggers the OnRemoteVideoStateChangedHandler callback to report the current state and the reason for the state change.

In the COMMUNICATION profile, this callback reports to you the video stream state information of all the remote users (excluding yours) in the channel once every two seconds.

In the LIVE_BROADCASTING profile, if you are the host, this callback reports to you the video stream state information of all the remote hosts (excluding yours) in the channel once every two seconds; if you are the audience, this callback reports to you the video stream state information of all the remote hosts in the channel once every two seconds.

• OnNetworkQualityHandler
• OnRtcStatsHandler
• OnLocalAudioStatsHandler
• OnLocalAudioStateChangedHandler
• OnRemoteAudioStatsHandler
• OnRemoteAudioStateChangedHandler
• OnLocalVideoStatsHandler
• OnLocalVideoStateChangedHandler
• OnRemoteVideoStatsHandler
• OnRemoteVideoStateChangedHandler

The SDK does not trigger the OnLocalAudioStateChangedHandler, OnRemoteAudioStateChangedHandler, OnLocalVideoStateChangedHandler, and OnRemoteVideoStateChangedHandler callbacks once every two seconds. See their respective trigger conditions on this page.