鸿蒙HarmonyOS NEXT开发实战：网络流量管理

鸿蒙开发往期必看：

HarmonyOS NEXT应用开发性能实践总结

一分钟了解”纯血版！鸿蒙HarmonyOS Next应用开发！

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

 “一杯冰美式的时间” 了解鸿蒙HarmonyOS Next应用开发路径！

---

简介

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

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

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

说明

为了保证应用的运行效率，大部分 API 调用都是异步的，对于异步调用的 API 均提供了 callback 和 Promise 两种方式，以下示例均采用 promise 函数，更多方式可以查阅API 参考。

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

接口说明

完整的 JS API 说明以及实例代码请参考：sstatistics 链接s。

接口名	描述
getIfaceRxBytes(nic: string, callback: AsyncCallback<number>): void;	获取指定网卡实时下行流量数据。
getIfaceTxBytes(nic: string, callback: AsyncCallback<number>): void;	获取指定网卡实时上行流量数据。
getCellularRxBytes(callback: AsyncCallback<number>): void;	获取蜂窝实时下行流量数据。
getCellularTxBytes(callback: AsyncCallback<number>): void;	获取蜂窝实时上行流量数据。
getAllRxBytes(callback: AsyncCallback<number>): void;	获取所有网卡实时下行流量数据。
getAllTxBytes(callback: AsyncCallback<number>): void;	获取所有网卡实时上行流量数据。
getUidRxBytes(uid: number, callback: AsyncCallback<number>): void;	获取指定应用实时下行流量数据。
getUidTxBytes(uid: number, callback: AsyncCallback<number>): void;	获取指定应用实时上行流量数据。
getSockfdRxBytes(sockfd: number, callback: AsyncCallback<number>): void;	获取指定socket实时下行流量数据。
getSockfdTxBytes(sockfd: number, callback: AsyncCallback<number>): void;	获取指定socket实时上行流量数据。

获取网卡/UID 的实时流量统计数据

1. 获取指定网卡实时流量数据。
2. 获取蜂窝实时流量数据。
3. 获取所有网卡实时流量数据。
4. 获取指定应用实时流量数据。
5. 获取指定socket实时流量数据。

// 从@kit.NetworkKit中导入statistics命名空间
import { statistics, socket } from '@kit.NetworkKit';
import { BusinessError } from '@kit.BasicServicesKit';

// 获取指定网卡实时下行流量数据。
statistics.getIfaceRxBytes("wlan0").then((stats: number) => {
  console.log(JSON.stringify(stats));
});

// 获取指定网卡实时上行流量数据。
statistics.getIfaceTxBytes("wlan0").then((stats: number) => {
  console.log(JSON.stringify(stats));
});

// 获取蜂窝实时下行流量数据。
statistics.getCellularRxBytes().then((stats: number) => {
  console.log(JSON.stringify(stats));
});

// 获取蜂窝实时上行流量数据。
statistics.getCellularTxBytes().then((stats: number) => {
  console.log(JSON.stringify(stats));
});

// 获取所有网卡实时下行流量数据。
statistics.getAllRxBytes().then((stats: number) => {
  console.log(JSON.stringify(stats));
});

// 获取所有网卡实时上行流量数据。
statistics.getAllTxBytes().then((stats: number) => {
  console.log(JSON.stringify(stats));
});

// 获取指定应用实时下行流量数据。
let uid = 20010038;
statistics.getUidRxBytes(uid).then((stats: number) => {
  console.log(JSON.stringify(stats));
});

// 获取指定应用实时上行流量数据。
let uids = 20010038;
statistics.getUidTxBytes(uids).then((stats: number) => {
  console.log(JSON.stringify(stats));
});

// 获取指定socket实时下行流量数据。
let tcp: socket.TCPSocket = socket.constructTCPSocketInstance();
tcp.getSocketFd().then((sockfd: number) => {
  statistics.getSockfdRxBytes(sockfd).then((stats: number) => {
    console.log(JSON.stringify(stats));
  }).catch((err: BusinessError) => {
    console.error(JSON.stringify(err));
  });
});

// 获取指定socket实时上行流量数据。
tcp.getSocketFd().then((sockfd: number) => {
  statistics.getSockfdTxBytes(sockfd).then((stats: number) => {
    console.log(JSON.stringify(stats));
  }).catch((err: BusinessError) => {
    console.error(JSON.stringify(err));
  });
});