ApsaraVideo Live:Test network quality before a call

Introdução ao recurso

O ARTC SDK permite testar a qualidade da rede local antes da entrada em um canal. Assim, você identifica e resolve possíveis problemas com antecedência, evitando travamentos, perda de quadros e interrupções de áudio durante chamadas de voz e vídeo em tempo real.

Código de exemplo

Android: Android/ARTCExample/AdvancedUsage/src/main/java/com/aliyun/artc/api/advancedusage/PreJoinChannelTest/PreJoinChannelTestActivity.java

iOS: iOS/ARTCExample/AdvancedUsage/PreJoinChannelTest/PreJoinChannelTestVC.swift

HarmonyOS：Harmony/ARTCExample/entry/src/main/ets/pages/advancedusage/PreJoinChannelTestPage.ets

Como funciona

O exemplo a seguir usa iOS. O ARTC SDK fornece o método startLastmileDetect para testar a qualidade da rede local antes de entrar em um canal e retornar pontuações de qualidade e estatísticas. O procedimento é o seguinte:

1. Antes de entrar em um canal, chame startLastmileDetect para iniciar o teste de qualidade de rede. Configure os parâmetros de teste em AliRtcNetworkQualityProbeConfig, incluindo o alvo do teste e a taxa de bits máxima esperada.

2. O SDK aciona os seguintes callbacks:

   • onLastmileDetectResultWithQuality: acionado 2 segundos após a chamada de startLastmileDetect. Retorna pontuações das redes de upstream e downstream, refletindo uma avaliação subjetiva.

   • onLastmileDetectResultWithBandWidth: acionado 30 segundos após a chamada de startLastmileDetect. Retorna dados em tempo real sobre as condições da rede, incluindo taxa de perda de pacotes, jitter de rede e largura de banda disponível, refletindo uma avaliação objetiva.

3. Após obter as estatísticas de qualidade da rede, chame stopLastmileDetect para interromper o teste de qualidade da rede local.

Exemplos de código

public abstract int startNetworkQualityProbeTest(AlirtcNetworkQualityProbeConfig config);

- (int)startLastmileDetect:(AliRtcNetworkQualityProbeConfig *_Nonnull)config;

AliRtcNetworkProbeConfig config;
config.probeUplink = true;    // Test the upstream network
config.probeDownlink = true;  // Test the downstream network

rtcEngine.startLastmileDetect(config);

public void onNetworkQualityProbeTest(AliRtcNetworkQuality quality){}

public void onNetworkQualityProbeTestResult(int code, AliRtcEngine.AlirtcNetworkQualityProbeResult result){}

- (void)onLastmileDetectResultWithQuality:(AliRtcNetworkQuality)networkQuality;

- (void)onLastmileDetectResultWithBandWidth:(int)code result:(AliRtcNetworkQualityProbeResult* _Nonnull)result;

// Handle network quality testing callback (replace onNetworkQualityChanged)
void OnLastmileDetectResultWithQuality(AliEngineNetworkQuality networkQuality) override {
    std::string message = getNetworkQualityString(networkQuality);
    networkTestResultText += "Network testing quality: " + message + "\n";
    std::cout << "=== Network quality testing callback ===" << std::endl;
    std::cout << networkTestResultText << std::endl;
}

// Handle lastmile network detection result callback
void onLastmileDetectResultWithBandWidth(int code,
                                       const AliRtcNetworkProbeResult& result) override {
    std::string message = buildNetworkTestResultMessage(code, result);
    networkTestResultText += message + "\n";
    std::cout << "=== Lastmile detection result callback ===" << std::endl;
    std::cout << networkTestResultText << std::endl;
}

public abstract int stopNetworkQualityProbeTest();

- (int)stopLastmileDetect;

rtcEngine.stopLastmileDetect();