输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
我的

HarmonyOS

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
版本说明
您当前正在浏览新版开发者文档中心，目录分类和层级有所调整。点击左侧当前文档分类名称前的“☰”图标，可切换文档分类。 了解新版目录
指南系统网络Network Boost Kit（网络加速服务）网络质量 (C/C++)网络质量评估 (C/C++)

网络质量评估 (C/C++)

更新时间: 2026-09-09 06:54
本文导读

场景介绍

应用在订阅网络质量Qos评估后，系统按照一定的周期或Qos变化后回调给应用。回调的Qos信息包括数据传输的链路类型、上下行空口实时带宽、上下行空口实时速率、RTT时延等。

接口说明

具体API说明详见接口文档。

展开
接口名 描述
int32_t HMS_NetworkBoost_RegisterNetQosCallback(HMS_NetworkBoost_NetQosChange callback, uint32_t* callbackId) 注册Qos信息状态变化回调。
int32_t HMS_NetworkBoost_UnregisterNetQosCallback(uint32_t callbackId) 取消注册Qos信息状态变化回调。

开发步骤

  1. 导入Network Boost Kit模块。

    #include "NetworkBoostKit/network_boost_quality.h"
#include <cstdio>

  2. CMakeLists.txt中添加以下lib，具体请见C API开发准备。

    libnetwork_boost.so

  3. 通过注册回调的方式监听网络质量评估信息。

    uint32_t callbackId = 0;
void onNetworkQoSChanged(NetworkBoost_NetworkQosArray *msg)
{
    for (int32_t i = 0; i < msg->pathNum; i++) {
        // 回调信息处理
        printf("数据链路类型: %d\n", msg->networkQos[i].pathType);
        printf("该数据链路类型的上行带宽: %ld\n", msg->networkQos[i].linkUpBandwidth);
        printf("该数据链路类型的下行带宽: %ld\n", msg->networkQos[i].linkDownBandwidth);
        // 单位为bps，若需转化为B/s，数值需要除以8
        printf("该数据链路类型的上行速率: %ld\n", msg->networkQos[i].linkUpRate);
        // 单位为bps，若需转化为B/s，数值需要除以8
        printf("该数据链路类型的下行速率: %ld\n", msg->networkQos[i].linkDownRate);
        // 实时速率为上行速率和下行速率之和
        printf("该数据链路类型的实时速率(B/s): %ld\n", (msg->networkQos[i].linkUpRate + msg->networkQos[i].linkDownRate) / 8);
        printf("该数据链路类型的RTT时延: %d\n", msg->networkQos[i].rttMs);
        printf("该数据链路类型的上行发送空口缓冲时延: %d\n", msg->networkQos[i].linkUpBufferDelayMs);
    }
}

int32_t RegisterNetQualityCallback()
{
    HMS_NetworkBoost_NetQosChange callback;
    callback = onNetworkQoSChanged;
    // 注册回调，获取回调Id，该Id由系统返回并用于后续取消注册操作
    int32_t ret = HMS_NetworkBoost_RegisterNetQosCallback(callback, &callbackId);
    printf("注册网络质量结果: %d, Id：%d\n", ret, callbackId);
    return ret;
}

  4. 当应用业务流程结束，通过取消注册的方式取消监听网络质量评估信息。

    int32_t UnregisterNetQualityCallback()
{
    // 使用注册时获取的回调Id取消注册
    int32_t ret = HMS_NetworkBoost_UnregisterNetQosCallback(callbackId);
    printf("取消注册网络质量结果: %d\n", ret);
    return ret;
}
网络质量 (C/C++)
网络场景识别 (C/C++)
相关推荐
文档网络质量评估
文档网络场景识别 (C/C++)
文档应用传输体验反馈 (C/C++)
文档NetworkBoost_NetworkQos
文档多网状态监听(C/C++)
文档netQuality（网络质量）
文档多网建议监听(C/C++)
文档连接迁移通知 (C/C++)
文档如何获取实时网络速度
文档网络场景识别
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明