@ohos.net.statistics (流量管理)（系统接口）

流量管理模块，支持基于网卡/UID 的实时流量统计和历史流量统计查询能力。

说明： 本模块首批接口从 API version 10 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 当前页面仅包含本模块的系统接口，其他公开接口参见@ohos.net.statistics (流量管理)

导入模块

import statistics from "@ohos.net.statistics";

statistics.on('netStatsChange')¹⁰⁺

on(type: 'netStatsChange', callback: Callback<NetStatsChangeInfo>): void

订阅流量改变事件通知。

系统接口：此接口为系统接口。

需要权限：ohos.permission.GET_NETWORK_STATS

系统能力：SystemCapability.Communication.NetManager.Core

参数：

错误码：

以下错误码的详细介绍参见statistics 错误码。

示例：

import statistics from '@ohos.net.statistics';

class IFace {
  iface: string = ""
  uid?: number = 0
}
statistics.on('netStatsChange', (data: IFace) => {
  console.log('on netStatsChange' + JSON.stringify(data));
});

statistics.off('netStatsChange')¹⁰⁺

off(type: 'netStatsChange', callback?: Callback<NetStatsChangeInfo>): void;

取消订阅流量改变事件通知。

系统接口：此接口为系统接口。

需要权限：ohos.permission.GET_NETWORK_STATS

系统能力：SystemCapability.Communication.NetManager.Core

参数：

错误码：

以下错误码的详细介绍参见statistics 错误码。

示例：

import statistics from '@ohos.net.statistics';

class IFace {
  iface: string = ""
  uid?: number = 0
}
let callback: (data: IFace) => void = (data: IFace) => {
    console.log("on netStatsChange, iFace:" + data.iface + " uid: " + data.uid);
}
statistics.on('netStatsChange', callback);
// 可以指定传入on中的callback取消一个订阅，也可以不指定callback清空所有订阅。
statistics.off('netStatsChange', callback);
statistics.off('netStatsChange');

statistics.getTrafficStatsByIface¹⁰⁺

getTrafficStatsByIface(ifaceInfo: IfaceInfo, callback: AsyncCallback<NetStatsInfo>): void;

获取指定网卡历史流量信息，使用 callback 方式作为异步方法。

系统接口：此接口为系统接口。

需要权限：ohos.permission.GET_NETWORK_STATS

系统能力：SystemCapability.Communication.NetManager.Core

参数：

错误码：

以下错误码的详细介绍参见statistics 错误码。

示例：

import { BusinessError } from '@ohos.base';
import statistics from '@ohos.net.statistics';

let iFaceInfo: statistics.IfaceInfo | null = null;
if (iFaceInfo) {
  statistics.getTrafficStatsByIface(iFaceInfo as statistics.IfaceInfo, (error: BusinessError, statsInfo: statistics.NetStatsInfo) => {
    console.log(JSON.stringify(error));
    console.log(
      "getTrafficStatsByIface bytes of received = " +
      JSON.stringify(statsInfo.rxBytes)
    );
    console.log(
      "getTrafficStatsByIface bytes of sent = " +
      JSON.stringify(statsInfo.txBytes)
    );
    console.log(
      "getTrafficStatsByIface packets of received = " +
      JSON.stringify(statsInfo.rxPackets)
    );
    console.log(
      "getTrafficStatsByIface packets of sent = " +
      JSON.stringify(statsInfo.txPackets)
    );
  });
}

statistics.getTrafficStatsByIface¹⁰⁺

getTrafficStatsByIface(ifaceInfo: IfaceInfo): Promise<NetStatsInfo>;

获取指定网卡历史流量信息，使用 Promise 方式作为异步方法。

系统接口：此接口为系统接口。

需要权限：ohos.permission.GET_NETWORK_STATS

系统能力：SystemCapability.Communication.NetManager.Core

返回值：

错误码：

以下错误码的详细介绍参见statistics 错误码。

示例：

import statistics from '@ohos.net.statistics';

let iFaceInfo: statistics.IfaceInfo | null = null;
if (iFaceInfo) {
  statistics.getTrafficStatsByIface(iFaceInfo as statistics.IfaceInfo).then((statsInfo: statistics.NetStatsInfo) => {
    console.log(
      "getTrafficStatsByIface bytes of received = " +
      JSON.stringify(statsInfo.rxBytes)
    );
    console.log(
      "getTrafficStatsByIface bytes of sent = " +
      JSON.stringify(statsInfo.txBytes)
    );
    console.log(
      "getTrafficStatsByIface packets of received = " +
      JSON.stringify(statsInfo.rxPackets)
    );
    console.log(
      "getTrafficStatsByIface packets of sent = " +
      JSON.stringify(statsInfo.txPackets)
    );
  });
}

statistics.getTrafficStatsByUid¹⁰⁺

getTrafficStatsByUid(uidInfo: UidInfo, callback: AsyncCallback<NetStatsInfo>): void;

获取指定应用历史流量信息，使用 callback 方式作为异步方法。

系统接口：此接口为系统接口。

需要权限：ohos.permission.GET_NETWORK_STATS

系统能力：SystemCapability.Communication.NetManager.Core

参数：

错误码：

以下错误码的详细介绍参见statistics 错误码。

示例：

import { BusinessError } from '@ohos.base';
import statistics from '@ohos.net.statistics';

let uidInfo: statistics.UidInfo = {
  uid: 20010037,
  ifaceInfo: {
    iface: '',
    startTime: 1,
    endTime: 3,
  }
}

statistics.getTrafficStatsByUid(
  uidInfo,
  (error: BusinessError, statsInfo: statistics.NetStatsInfo) => {
    console.log(JSON.stringify(error));
    console.log(
      "getTrafficStatsByUid bytes of received = " +
      JSON.stringify(statsInfo.rxBytes)
    );
    console.log(
      "getTrafficStatsByUid bytes of sent = " +
      JSON.stringify(statsInfo.txBytes)
    );
    console.log(
      "getTrafficStatsByUid packets of received = " +
      JSON.stringify(statsInfo.rxPackets)
    );
    console.log(
      "getTrafficStatsByUid packets of sent = " +
      JSON.stringify(statsInfo.txPackets)
    );
  }
);

statistics.getTrafficStatsByUid¹⁰⁺

getTrafficStatsByUid(uidInfo: UidInfo): Promise<NetStatsInfo>;

获取指定应用历史流量信息，使用 Promise 方式作为异步方法。

系统接口：此接口为系统接口。

需要权限：ohos.permission.GET_NETWORK_STATS

系统能力：SystemCapability.Communication.NetManager.Core

参数：

返回值：

错误码：

以下错误码的详细介绍参见statistics 错误码。

示例：

import statistics from '@ohos.net.statistics'

let uidInfo: statistics.UidInfo = {
  uid: 20010037,
  ifaceInfo: {
    iface: '',
    startTime: 1,
    endTime: 3,
  }
}

statistics.getTrafficStatsByUid(uidInfo).then((statsInfo: statistics.NetStatsInfo) => {
  console.log("getTrafficStatsByUid bytes of received = " + JSON.stringify(statsInfo.rxBytes));
  console.log("getTrafficStatsByUid bytes of sent = " + JSON.stringify(statsInfo.txBytes));
  console.log("getTrafficStatsByUid packets of received = " + JSON.stringify(statsInfo.rxPackets));
  console.log("getTrafficStatsByUid packets of sent = " + JSON.stringify(statsInfo.txPackets));
})

IfaceInfo¹⁰⁺

查询网卡历史流量参数信息。

系统接口：此接口为系统接口。

系统能力：SystemCapability.Communication.NetManager.Core

UidInfo¹⁰⁺

查询应用历史流量参数信息。

系统接口：此接口为系统接口。

系统能力：SystemCapability.Communication.NetManager.Core

NetStatsInfo¹⁰⁺

获取的历史流量信息。

系统接口：此接口为系统接口。

系统能力：SystemCapability.Communication.NetManager.Core

NetStatsChangeInfo¹¹⁺

监听和管理网络接口的状态和使用情况

系统接口：此接口为系统接口。

系统能力：SystemCapability.Communication.NetManager.Core