RTC Engine

Web
- Run Sample Demo
- Integration
- Basic Features
  - Screen Sharing
  - Live Streaming
  - Media Device
  - Audio Volume
  - Set Encoding Profile
  - Detect Network Quality
  - Detect Capabilities
- Advance Features
  - Enable AI Denoiser
  - Enable Audio Mixer
  - Enable Watermark
  - Enable Virtual Background
  - Enable Beauty and Effects
  - Data Messages
  - Custom Capturing and Rendering
- API List
- Released Notes
- Supported Platforms
- Web FAQs
  - Optimize Multi-Person Video Calls
  - Handle Autoplay Restriction
  - Handle Firewall Restriction
  - Others
Android
- Run Sample Code
- Integration
- Basic Features
  - Sensing Network Quality
  - Enabling Screen Sharing
  - Setting Video Quality
  - Rotating Videos
- Advanced Features
  - Testing Newwork Quality
  - Custom Capturing and Rendering
  - Custom Audio Capturing and Playback
- Client APIs
  - Overview
  - TRTCCloud
  - TRTCStatistics
  - TRTCCloudListener
  - TXAudioEffectManager
  - TXBeautyManager
  - TXDeviceManager
  - Type Definition
  - Deprecated Interface
  - Error Codes
- Solution
  - Real-Time Chorus (TUIKaraoke)
    - Quick Integration
    - Implementation Steps
    - Song Synchronization
    - Lyric Synchronization
    - Vocal Synchronization
    - Mixing Stream Solution
    - TRTCKaraoke APIs
    - FAQs
- Release Notes
iOS
- Run Sample Code
- Integration
- Basic Features
  - Sensing Network Quality
  - Enabling Screen Sharing
  - Setting Video Quality
  - Rotating Videos
- Advanced Features
  - Testing Network Quality
  - Custom Capturing and Rendering
  - Custom Audio Capturing and Playback
- Client APIs
  - Overview
  - TRTCCloud
  - TRTCCloudDelegate
  - TRTCStatistics
  - TXAudioEffectManager
  - TXBeautyManager
  - TXDeviceManager
  - Type Definition
  - Deprecated Interface
  - ErrorCode
- Solution
  - Quick Integration
  - Implementation Steps
  - Song Synchronization
  - Lyric Synchronization
  - Vocal Synchronization
  - Mixing Stream Solution
  - TRTCKaraoke APIs
  - FAQs
- Release Notes
macOS
- Run Sample Code
- Integration
- Basic Features
  - Sensing Network Quality
  - Enabling Screen Sharing
  - Sharing Computer Audio
  - Setting Video Quality
  - Rotating Videos
- Advanced Features
  - Testing Hardware Devices
  - Testing Network Quality
  - Custom Capturing and Rendering
  - Custom Audio Capturing and Playback
- Client APIs
  - Overview
  - TRTCCloud
  - TRTCCloudDelegate
  - TRTCStatistics
  - TXAudioEffectManager
  - TXBeautyManager
  - TXDeviceManager
  - Type Definition
  - Deprecated Interface
  - ErrorCode
  - Release Notes
- Release Notes
Windows
- Run Sample Code
- Integration
- Basic Features
  - Sensing Network Quality
  - Enabling Screen Sharing
  - Setting Video Quality
  - Rotating Videos
- Advanced Features
  - Testing Hardware Devices
  - Testing Network Quality
  - Custom Capturing and Rendering
  - Custom Audio Capturing and Playback
- Client APIs
  - Overview
  - ITRTCCloud
  - ITRTCStatistics
  - TRTCCloudCallback
  - ITXAudioEffectManager
  - ITXDeviceManager
  - Type Definition
  - Deprecated Interface
  - Error Codes
- Release Notes
Electron
- Integration
  - 1.API Examples
  - 2.Importing the SDK
  - 3.Entering a Room
  - 4.Subscribing to Audio/Video Streams
  - 5.Publish Audio/Video Streams
  - 6.Exiting a Room
  - 7.Sensing Network Quality
  - 8.Enabling Screen Sharing
  - 9.Sharing Computer Audio
  - 10.Setting Video Quality
  - 11.Rotating Videos
- Client APIs
  - Overview
  - Error Codes
Flutter
- Integration
  - 1.API Examples
  - 2.Importing the SDK
  - 3.Entering a Room
  - 4.Subscribing to Audio/Video Streams
  - 5.Publish Audio/Video Streams
  - 6.Exiting a Room
  - 7.Sensing Network Quality
  - 8.Enabling Screen Sharing
  - 9.Sharing Computer Audio
  - 10.Setting Video Quality
  - 11.Rotating Videos
- Client APIs
  - Overview
  - Error Codes
Unity
- Integration
  - 1.API Examples
  - 2Importing the SDK
- Client APIs
  - Overview
  - Error Codes
Qt
- Integration
  - 1.Importing the SDK
Overview
- Overview

RTC Engine

Sensing Network Quality

This document describes how to assess the current network conditions.
When you have a video call on WeChat under poor network conditions (for example, when you are in an elevator), WeChat displays a message indicating the current network quality is poor. This document describes how to use TRTC to implement a similar interaction in your own application.
﻿
﻿
﻿
Call Guide
TRTC provides the onNetworkQuality callback to report the current network quality once every two seconds. It contains two parameters: localQuality and remoteQuality.
localQuality indicates your current network quality, which has six levels: Excellent, Good, Poor, Bad, VeryBad, and Down.
remoteQuality is an array indicating the network quality of remote users. In this array, each element represents the network quality of a remote user.
Quality
Name
Description
0
Unknown
Unknown
1
Excellent
The current network is excellent.
2
Good
The current network is good.
3
Poor
The current network is fine.
4
Bad
The current network is poor, and there may be obvious stuttering and delay.
5
VeryBad
The current network is very poor, and TRTC can merely sustain the connection but cannot guarantee the communication quality.
6
Down
The current network cannot meet the minimum requirements of TRTC, and it is impossible to have a normal audio/video call.
You only need to listen for onNetworkQuality of TRTC and display the corresponding prompt on the UI.
Android 
iOS&Mac 
Windows 
// Listen for the `onNetworkQuality` callback to get the change of the current network conditions
@Override
public void onNetworkQuality(TRTCCloudDef.TRTCQuality localQuality,
                             ArrayList<TRTCCloudDef.TRTCQuality> remoteQuality)
{
    // Get your local network quality
    switch(localQuality) {
        case TRTCQuality_Unknown:
            Log.d(TAG, "SDK has not yet sensed the current network quality.");
            break;
        case TRTCQuality_Excellent:
            Log.d(TAG, "The current network is very good.");
            break;
        case TRTCQuality_Good:
            Log.d(TAG, "The current network is good.");
            break;
        case TRTCQuality_Poor:
            Log.d(TAG, "The current network quality barely meets the demand.");
            break;
        case TRTCQuality_Bad:
            Log.d(TAG, "The current network is poor, and there may be significant freezes and call delays.");
            break;
        case TRTCQuality_VeryBad:
            Log.d(TAG, "The current network is very poor, the communication quality cannot be guaranteed");
            break;
        case TRTCQuality_Down:
            Log.d(TAG, "The current network does not meet the minimum requirements.");
            break;
        default:
            break;
    }
    // Get the network quality of remote users
    for (TRTCCloudDef.TRTCQuality info : arrayList) {
        Log.d(TAG, "remote user : = " + info.userId + ", quality = " + info.quality);
    }
}
﻿
// Listen for the `onNetworkQuality` callback to get the change of the current network conditions
- (void)onNetworkQuality:(TRTCQualityInfo *)localQuality remoteQuality:(NSArray<TRTCQualityInfo *> *)remoteQuality {
    // Get your local network quality
    switch(localQuality.quality) {
        case TRTCQuality_Unknown:
            NSLog(@"SDK has not yet sensed the current network quality.");
            break;
        case TRTCQuality_Excellent:
            NSLog(@"The current network is very good.");
            break;
        case TRTCQuality_Good:
            NSLog(@"The current network is good.");
            break;
        case TRTCQuality_Poor:
            NSLog(@"The current network quality barely meets the demand.");
            break;
        case TRTCQuality_Bad:
            NSLog(@"The current network is poor, and there may be significant freezes and call delays.");
            break;
        case TRTCQuality_VeryBad:
           NSLog(@"The current network is very poor, the communication quality cannot be guaranteed");
            break;
        case TRTCQuality_Down:
            NSLog(@"The current network does not meet the minimum requirements.");
            break;
        default:
            break;
    }
    // Get the network quality of remote users
    for (TRTCQualityInfo *info in arrayList) {
        NSLog(@"remote user : = %@, quality = %@", info.userId, @(info.quality));
    }
}
﻿
// Listen for the `onNetworkQuality` callback to get the change of the current network conditions
void onNetworkQuality(liteav::TRTCQualityInfo local_quality,
    liteav::TRTCQualityInfo* remote_quality, uint32_t remote_quality_count) {
    // Get your local network quality
    switch (local_quality.quality) {
    case TRTCQuality_Unknown:
        printf("SDK has not yet sensed the current network quality.");
        break;
    case TRTCQuality_Excellent:
        printf("The current network is very good.");
        break;
    case TRTCQuality_Good:
        printf("The current network is good.");
        break;
    case TRTCQuality_Poor:
        printf("The current network quality barely meets the demand.");
        break;
    case TRTCQuality_Bad:
        printf("The current network is poor, and there may be significant freezes and call delays.");
        break;
    case TRTCQuality_Vbad:
        printf("The current network is very poor, the communication quality cannot be guaranteed");
        break;
    case TRTCQuality_Down:
        printf("The current network does not meet the minimum requirements.");
        break;
    default:
        break;
    }
    // Get the network quality of remote users
    for (int i = 0; i < remote_quality_count; ++i) {
        printf("remote user : = %s, quality = %d", remote_quality[i].userId, remote_quality[i].quality);
    }
}
﻿

Call Guide

Quality	Name	Description
0	Unknown	Unknown
1	Excellent	The current network is excellent.
2	Good	The current network is good.
3	Poor	The current network is fine.
4	Bad	The current network is poor, and there may be obvious stuttering and delay.
5	VeryBad	The current network is very poor, and TRTC can merely sustain the connection but cannot guarantee the communication quality.
6	Down	The current network cannot meet the minimum requirements of TRTC, and it is impossible to have a normal audio/video call.