네트워크 품질의 모니터링

//네트워크 속도 측정을 시작하는 예제 코드는 sdkAppId와 UserSig가 필요합니다. (받은 방법은 기본 기능 참조하세요)
// 로그인 후 테스트를 시작하는 것을 예로 들면
- (void)onLogin:(NSString *)userId userSig:(NSString *)userSid 
{
    TRTCSpeedTestParams *params;
    // sdkAppID는 콘솔에서 받은 실제 애플리케이션의 AppID입니다.
    params.sdkAppID = sdkAppId;
    params.userID = userId;
    params.userSig = userSig;
    // 예상 업로드 대역폭 (kbps, 범위: 10 ~ 5000, 0인 경우 테스트하지 않음)
    params.expectedUpBandwidth = 5000;
    // 예상 다운로드 대역폭 (kbps, 범위: 10 ~ 5000, 0인 경우 테스트하지 않음)
    params.expectedDownBandwidth = 5000;
    [trtcCloud startSpeedTest:params];
}
- (void)onSpeedTestResult:(TRTCSpeedTestResult *)result {
    // 속도 측정이 완료되면 속도 측정 결과로 돌아갑니다.
}

//네트워크 속도 측정을 시작하는 예제 코드는 sdkAppId와 UserSig가 필요합니다. (받은 방법은 기본 기능 참조하세요)
// 로그인 후 테스트를 시작하는 것을 예로 들면
void onLogin(const char* userId, const char* userSig)
{
    TRTCSpeedTestParams params;
    // sdkAppID는 콘솔에서 받은 실제 애플리케이션의 AppID입니다.
    params.sdkAppID = sdkAppId;
    params.userId = userid;
    param.userSig = userSig;
    // 예상 업로드 대역폭 (kbps, 범위: 10 ~ 5000, 0인 경우 테스트하지 않음)
    param.expectedUpBandwidth = 5000;
    // 예상 다운로드 대역폭 (kbps, 범위: 10 ~ 5000, 0인 경우 테스트하지 않음)
    param.expectedDownBandwidth = 5000;
    trtcCloud->startSpeedTest(params);
}

// 속도 측정 결과를 모리터링합니다.
void TRTCCloudCallbackImpl::onSpeedTestResult(
             const TRTCSpeedTestResult& result)
{
    // 속도 측정이 완료되면 속도 측정 결과가 콜백됩니다.
}

// onNetworkQuality 콜백을 모니터링하여 현재 네트워크 상태 변화를 감지합니다.
- (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));
    }
}

iOSMac

// onNetworkQuality 콜백을 모니터링하여 현재 네트워크 상태 변화를 감지합니다.
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);
    }
}



- (void)onStatistics:(TRTCStatistics *)statistics {
    // appCpu 사용률
    NSLog(@"appCpu: %u", statistics.appCpu);
        // systemCpu 사용률
    NSLog(@"systemCpu: %u", statistics.systemCpu);
    // rtt SDK에서 클라우드까지의 왕복 지연 시간
    NSLog(@"rtt: %d", statistics.rtt);
    // upLoss 업로드 패킷 손실률
    NSLog(@"upLoss: %u", statistics.upLoss);
    // downLoss 다운로드 패킷 손실률
    NSLog(@"downLoss: %u", statistics.downLoss);
    // gatewayRtt 게이트웨이에서 클라우드까지의 왕복 지연 시간
    NSLog(@"gatewayRtt: %d", statistics.gatewayRtt);
    // sendBytes 전송된 바이트 수
    NSLog(@"sendBytes: %llu", (unsigned long long)statistics.sentBytes);
    // receiveBytes 수신 바이트 수
    NSLog(@"receiveBytes: %llu", (unsigned long long)statistics.receivedBytes);

    if (statistics.localStatistics != nil) {
        for (int i = 0; i < statistics.localStatistics.count; i++) {
            // 로컬 비디오 너비
            NSLog(@"localStatistics width: %d", statistics.localStatistics[i].width);
            // 로컬 비디오 높이
            NSLog(@"localStatistics height: %d", statistics.localStatistics[i].height);
            // 로컬 비디오 프레임 레이트
            NSLog(@"localStatistics frameRate: %u", statistics.localStatistics[i].frameRate);
            // 로컬 비디오 비트레이트
            NSLog(@"localStatistics videoBitrate: %d", statistics.localStatistics[i].videoBitrate);
            // 로컬 오디오 비트레이트
            NSLog(@"localStatistics audioBitrate: %d", statistics.localStatistics[i].audioBitrate);
            // 로컬 오디오 장치의 수집 상태
            NSLog(@"localStatistics audioCaptureState: %d", statistics.localStatistics[i].audioCaptureState);
            // 로컬 오디오 샘플링 레이트
            NSLog(@"localStatistics audioSampleRate: %d", statistics.localStatistics[i].audioSampleRate);
            // 로컬 스트림 유형
            NSLog(@"localStatistics streamType: %ld", (long)statistics.localStatistics[i].streamType);
        }
    }

    if (statistics.remoteStatistics != nil) {
        for (int i = 0; i < statistics.remoteStatistics.count; i++) {
            // 원격 사용자 userid
            NSLog(@"remoteStatistics userId: %@", statistics.remoteStatistics[i].userId);
            // 원격 사용자 스트림 유형
            NSLog(@"remoteStatistics streamType: %ld", (long)statistics.remoteStatistics[i].streamType);
            // 원격 비디오 너비
            NSLog(@"remoteStatistics width: %d", statistics.remoteStatistics[i].width);
            // 원격 비디오 높이
            NSLog(@"remoteStatistics height: %d", statistics.remoteStatistics[i].height);
            // 원격 비디오 프레임 레이트
            NSLog(@"remoteStatistics frameRate: %u", statistics.remoteStatistics[i].frameRate);
            // 원격 비디오 비트레이트
            NSLog(@"remoteStatistics videoBitrate: %d", statistics.remoteStatistics[i].videoBitrate);
            // 원격 비디오 정지률
            NSLog(@"remoteStatistics videoBlockRate: %u", statistics.remoteStatistics[i].videoBlockRate);
            // 비디오 재생의 누적 정지 시간
            NSLog(@"remoteStatistics videoTotalBlockTime: %d", statistics.remoteStatistics[i].videoTotalBlockTime);
            // 해당 비디오 스트림의 총 패킷 손실률
            NSLog(@"remoteStatistics videoPacketLoss: %u", statistics.remoteStatistics[i].videoPacketLoss);
            // 원격 오디오 비트레이트
            NSLog(@"remoteStatistics audioBitrate: %d", statistics.remoteStatistics[i].audioBitrate);
            // 원격 오디오 재생의 정지률
            NSLog(@"remoteStatistics audioBlockRate: %u", statistics.remoteStatistics[i].audioBlockRate);
            // 원격 오디오의 샘플링 레이트
            NSLog(@"remoteStatistics audioSampleRate: %d", statistics.remoteStatistics[i].audioSampleRate);
            // 원격 오디오 패킷 손실률
            NSLog(@"remoteStatistics audioPacketLoss: %u", statistics.remoteStatistics[i].audioPacketLoss);
            // 오디오 재생의 누적 정지 시간
            NSLog(@"remoteStatistics audioTotalBlockTime: %d", statistics.remoteStatistics[i].audioTotalBlockTime);
            // 재생 지연
            NSLog(@"remoteStatistics jitterBufferDelay: %d", statistics.remoteStatistics[i].jitterBufferDelay);
            // 엔드투엔드 지연
            NSLog(@"remoteStatistics point2PointDelay: %d", statistics.remoteStatistics[i].point2PointDelay);
        }
    }

}


void onStatistics(const TRTCStatistics& statistics) {
	// appCpu 사용률
	printf("appCpu: %f\n", statistics.appCpu);
	// systemCpu 사용률
	printf("systemCpu: %f\n", statistics.systemCpu);
	// rtt SDK에서 클라우드까지의 왕복 지연 시간
	printf("rtt: %d\n", statistics.rtt);
	// upLoss 업로드 패킷 손실률
	printf("upLoss: %f\n", statistics.upLoss);
	// downLoss 다운로드 패킷 손실률
	printf("downLoss: %f\n", statistics.downLoss);
	// gatewayRtt 게이트웨이에서 클라우드까지의 왕복 지연 시간
	printf("gatewayRtt: %d\n", statistics.gatewayRtt);
	// sentBytes 전송된 바이트 수
	printf("sentBytes: %lld\n", statistics.sentBytes); 
	// receiveBytes 수신 바이트 수
	printf("receivedBytes: %lld\n", statistics.receivedBytes);

	//for (const auto& localStat : statistics.localStatisticsArray) {
	if (statistics.localStatisticsArray != nullptr && statistics.localStatisticsArraySize != 0)
	{
		for (int i = 0; i < statistics.localStatisticsArraySize; i++)
		{
			// 로컬 비디오 너비
			printf("localStatistics width: %d\n", statistics.localStatisticsArray[i].width);
			// 로컬 비디오 높이
			printf("localStatistics height: %d\n", statistics.localStatisticsArray[i].height);
			// 로컬 비디오 프레임 레이트
			printf("localStatistics frameRate: %f\n", statistics.localStatisticsArray[i].frameRate);
			// 로컬 비디오 비트레이트
			printf("localStatistics videoBitrate: %d\n", statistics.localStatisticsArray[i].videoBitrate);
			// 로컬 오디오 비트레이트
			printf("localStatistics audioBitrate: %d\n", statistics.localStatisticsArray[i].audioBitrate);
			// 로컬 오디오 장치의 수집 상태
			printf("localStatistics audioCaptureState: %d\n", statistics.localStatisticsArray[i].audioCaptureState);
			// 로컬 오디오 샘플링 레이트
			printf("localStatistics audioSampleRate: %d\n", statistics.localStatisticsArray[i].audioSampleRate);
			// 로컬 스트림 유형
			printf("localStatistics streamType: %d\n", statistics.localStatisticsArray[i].streamType);
		}
	}

	//for (const auto& remoteStat : statistics.remoteStatisticsArray) {
	if (statistics.remoteStatisticsArray != nullptr && statistics.remoteStatisticsArraySize != 0)
	{
		for (int i = 0; i < statistics.remoteStatisticsArraySize; i++)
		{
			// 원격 사용자 userid
			printf("remoteStatistics userId: %s\n", statistics.remoteStatisticsArray[i].userId);
			// 원격 사용자 스트림 유형
			printf("remoteStatistics streamType: %d\n", statistics.remoteStatisticsArray[i].streamType);
			// 원격 비디오 너비
			printf("remoteStatistics width: %d\n", statistics.remoteStatisticsArray[i].width);
			// 원격 비디오 높이
			printf("remoteStatistics height: %d\n", statistics.remoteStatisticsArray[i].height);
			// 원격 비디오 프레임 레이트
			printf("remoteStatistics frameRate: %f\n", statistics.remoteStatisticsArray[i].frameRate);
			// 원격 비디오 비트레이트
			printf("remoteStatistics videoBitrate: %d\n", statistics.remoteStatisticsArray[i].videoBitrate);
			// 원격 비디오 정지률
			printf("remoteStatistics videoBlockRate: %f\n", statistics.remoteStatisticsArray[i].videoBlockRate);
			// 비디오 재생의 누적 정지 시간
			printf("remoteStatistics videoTotalBlockTime: %d\n", statistics.remoteStatisticsArray[i].videoTotalBlockTime);
			// 해당 비디오 스트림의 총 패킷 손실률
			printf("remoteStatistics videoPacketLoss: %f\n", statistics.remoteStatisticsArray[i].videoPacketLoss);
			// 원격 오디오 비트레이트
			printf("remoteStatistics audioBitrate: %d\n", statistics.remoteStatisticsArray[i].audioBitrate);
			// 원격 오디오 재생의 정지률
			printf("remoteStatistics audioBlockRate: %f\n", statistics.remoteStatisticsArray[i].audioBlockRate);
			// 원격 오디오의 샘플링 레이트
			printf("remoteStatistics audioSampleRate: %d\n", statistics.remoteStatisticsArray[i].audioSampleRate);
			// 원격 오디오 패킷 손실률
			printf("remoteStatistics audioPacketLoss: %f\n", statistics.remoteStatisticsArray[i].audioPacketLoss);
			// 오디오 재생의 누적 정지 시간
			printf("remoteStatistics audioTotalBlockTime: %d\n", statistics.remoteStatisticsArray[i].audioTotalBlockTime);
			// 재생 지연
			printf("remoteStatistics jitterBufferDelay: %d\n", statistics.remoteStatisticsArray[i].jitterBufferDelay);
			// 엔드투엔드 지연
			printf("remoteStatistics point2PointDelay: %d\n", statistics.remoteStatisticsArray[i].point2PointDelay);
		}
	}
}