统计网络流量消耗
========

#### 简介

流量管理提供了基于物理网络的数据流量统计能力，支持基于网卡/UID 的流量统计。

流量管理主要实现功能有：

*   支持基于网卡/UID 的实时流量统计。
*   支持基于网卡/UID 的历史流量统计。
*   支持基于网卡/UID 的流量变化订阅。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/be/v3/LH6KgL5KRMWEv9pVxBD9vw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073431Z&HW-CC-Expire=86400&HW-CC-Sign=3B3965BAA452D4D74FA54FD864E750003D7A36F80960FBF5F5D12C360307A065)

为了保证应用的运行效率，大部分 API 调用都是异步的，对于异步调用的 API 均提供了 callback 和 Promise 两种方式，以下示例均采用 Promise 函数，更多方式可以查阅[@ohos.net.statistics (流量管理)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-net-statistics)。

以下分别介绍具体开发方式。

#### 开发步骤

1.  导入[statistics](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-net-statistics)、[socket](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-socket)以及错误码模块。
    
    import { socket, statistics } from '@kit.NetworkKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    
2.  获取指定网卡实时流量数据
    
    调用[getIfaceRxBytes](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-net-statistics#statisticsgetifacerxbytes-1)接口传入网卡名获取实时下行流量数据。
    
      // wlan0为主WiFi网卡名，获取主WiFi实时下行流量数据。
      statistics.getIfaceRxBytes('wlan0').then((stats: number) => {
        hilog.info(0x0000, 'testTag', JSON.stringify(stats));
        // ...
      })
      .catch((err: BusinessError) => {
        hilog.error(0x0000, 'testTag', JSON.stringify(err));
        // ...
      });
      // ...
      // wlan0为主WiFi网卡名，获取主WiFi实时上行流量数据。
      statistics.getIfaceTxBytes('wlan0').then((stats: number) => {
        hilog.info(0x0000, 'testTag', JSON.stringify(stats));
        // ...
      })
      .catch((err: BusinessError) => {
        hilog.error(0x0000, 'testTag', JSON.stringify(err));
        // ...
      });
    // ...
    
3.  获取蜂窝实时流量数据
    
    调用[getCellularRxBytes](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-net-statistics#statisticsgetcellularrxbytes-1)接口获取蜂窝实时上下行流量数据。
    
    // 获取蜂窝实时下行流量数据。
    statistics.getCellularRxBytes().then((stats: number) => {
      hilog.info(0x0000, 'testTag', JSON.stringify(stats));
      // ...
    })
    // ...
    // 获取蜂窝实时上行流量数据。
    statistics.getCellularTxBytes().then((stats: number) => {
      hilog.info(0x0000, 'testTag', JSON.stringify(stats));
      // ...
    })
    // ...
    
4.  获取所有网卡实时流量数据
    
    调用[getAllRxBytes](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-net-statistics#statisticsgetallrxbytes-1)接口获取所有网卡实时上下行流量数据。
    
    // 获取所有网卡实时下行流量数据。
    statistics.getAllRxBytes().then((stats: number) => {
      hilog.info(0x0000, 'testTag', JSON.stringify(stats));
      // ...
    })
    // ...
    // 获取所有网卡实时上行流量数据。
    statistics.getAllTxBytes().then((stats: number) => {
      hilog.info(0x0000, 'testTag', JSON.stringify(stats));
      // ...
    })
    // ...
    
5.  获取指定应用实时流量数据
    
    调用[getUidRxBytes](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-net-statistics#statisticsgetuidrxbytes-1)接口，传入UID获取指定应用实时上下行流量数据。
    
     let UID = 20010038;
    
    // 获取指定应用实时下行流量数据。
    // ...
    statistics.getUidRxBytes(UID).then((stats: number) => {
      hilog.info(0x0000, 'testTag', JSON.stringify(stats));
      // ...
    })
    // ...
    // 获取指定应用实时上行流量数据。
    // ...
    statistics.getUidTxBytes(UID).then((stats: number) => {
      hilog.info(0x0000, 'testTag', JSON.stringify(stats));
      // ...
    })
    // ...
    
6.  获取指定socket实时流量数据
    
    调用[getSockfdRxBytes](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-net-statistics#statisticsgetsockfdrxbytes11-1)接口，传入指定的sockFd获取指定socket实时上下行流量数据。
    
    // 获取指定socket实时下行流量数据。
    let tcp: socket.TCPSocket = socket.constructTCPSocketInstance();
    // ...
    tcp.getSocketFd().then((sockfd: number) => {
      statistics.getSockfdRxBytes(sockfd).then((stats: number) => {
        hilog.info(0x0000, 'testTag', JSON.stringify(stats));
        // ...
      }).catch((err: BusinessError) => {
        hilog.error(0x0000, 'testTag', JSON.stringify(err));
        // ...
      });
    })
    // ...
    // 获取指定socket实时上行流量数据。
    tcp.getSocketFd().then((sockfd: number) => {
      statistics.getSockfdTxBytes(sockfd).then((stats: number) => {
        hilog.info(0x0000, 'testTag', JSON.stringify(stats));
        // ...
      }).catch((err: BusinessError) => {
        hilog.error(0x0000, 'testTag', JSON.stringify(err));
        // ...
      });
    })
    // ...