智能客服
你问我答，随时在线为你解决问题
本模块首批接口从 API version 10 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
@ohos.net.statistics (流量管理)
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
本文导读
流量管理模块提供获取设备网络流量数据的能力。该模块支持从多个维度查询数据包的流量使用情况，例如：
- 支持获取指定网卡的上/下行流量数据；
- 支持获取所有网卡的总流量数据，便于查看设备整体网络使用情况；
- 支持根据应用uid获取指定应用的流量数据，帮助开发者监控应用的网络资源消耗；
- 支持获取指定socket的流量统计，为细粒度的网络性能分析提供数据基础；
- 支持获取应用在指定时间段内的历史流量使用情况，便于分析应用的长期网络使用趋势。
说明
导入模块
- import { statistics } from '@kit.NetworkKit';
statistics.getIfaceRxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getIfaceRxBytes(nic: string, callback: AsyncCallback<number>): void
获取指定网卡从最近一次开机开始至接口调用时刻的下行流量总和（单位：字节）。使用callback异步回调。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| nic | string | 是 | 指定查询的网卡名。 |
| callback | AsyncCallback<number> | 是 | 回调函数。当成功获取到流量数据时，error为undefined，否则为错误对象。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
| 2103012 | Failed to obtain the NIC name. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { statistics } from '@kit.NetworkKit';
-
- statistics.getIfaceRxBytes("wlan0", (error: BusinessError, stats: number) => {
- if (error) {
- console.error(`getIfaceRxBytes error, ${JSON.stringify(error)}`);
- return;
- }
- console.info(`getIfaceRxBytes success, ${JSON.stringify(stats)}`);
- });
statistics.getIfaceRxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getIfaceRxBytes(nic: string): Promise<number>
获取指定网卡从最近一次开机开始至接口调用时刻的下行流量总和（单位：字节）。使用Promise异步回调。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| nic | string | 是 | 指定查询的网卡名。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise<number> | Promise对象。返回指定网卡从最近一次开机开始到现在的下行流量总和（单位：字节）。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
| 2103012 | Failed to obtain the NIC name. |
示例：
- import { statistics } from '@kit.NetworkKit';
- import { BusinessError } from '@kit.BasicServicesKit';
-
- statistics.getIfaceRxBytes("wlan0").then((stats: number) => {
- console.info(JSON.stringify(stats));
- }).catch((err: BusinessError) => {
- console.error(JSON.stringify(err));
- });
statistics.getIfaceTxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getIfaceTxBytes(nic: string, callback: AsyncCallback<number>): void
获取指定网卡从最近一次开机开始至接口调用时刻的上行流量总和（单位：字节）。使用callback异步回调。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| nic | string | 是 | 指定查询的网卡名。 |
| callback | AsyncCallback<number> | 是 | 回调函数。当成功获取到流量数据时，error为undefined，否则为错误对象。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
| 2103012 | Failed to obtain the NIC name. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { statistics } from '@kit.NetworkKit';
-
- statistics.getIfaceTxBytes("wlan0", (error: BusinessError, stats: number) => {
- if (error) {
- console.error(`getIfaceTxBytes error, ${JSON.stringify(error)}`);
- return;
- }
- console.info(`getIfaceTxBytes success, ${JSON.stringify(stats)}`);
- });
statistics.getIfaceTxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getIfaceTxBytes(nic: string): Promise<number>
获取指定网卡从最近一次开机开始至接口调用时刻的上行流量总和（单位：字节）。使用Promise异步回调。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| nic | string | 是 | 指定查询的网卡名。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise<number> | Promise对象。返回指定网卡从最近一次开机开始至接口调用时刻的上行流量总和（单位：字节）。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
| 2103012 | Failed to obtain the NIC name. |
示例：
- import { statistics } from '@kit.NetworkKit';
- import { BusinessError } from '@kit.BasicServicesKit';
-
- statistics.getIfaceTxBytes("wlan0").then((stats: number) => {
- console.info(`getIfaceTxBytes success, ${JSON.stringify(stats)}`);
- }).catch((err: BusinessError) => {
- console.error(`getIfaceTxBytes error, ${JSON.stringify(err)}`);
- });
statistics.getCellularRxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getCellularRxBytes(callback: AsyncCallback<number>): void
获取当前已处于连接状态的蜂窝网络对应的网卡从最近一次开机开始至接口调用时刻的下行流量总和（单位：字节）。使用callback异步回调。
说明
本接口建议在蜂窝网络处于连接状态时调用，否则会抛出2103012错误码。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| callback | AsyncCallback<number> | 是 | 回调函数。当成功获取到流量数据时，error为undefined，否则为错误对象。 |
错误码：
以下错误码的详细介绍参见流量管理错误码。
| 错误码ID | 错误信息 |
|---|---|
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
| 2103012 | Failed to obtain the NIC name. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { statistics } from '@kit.NetworkKit';
-
- statistics.getCellularRxBytes((error: BusinessError, stats: number) => {
- if (error) {
- console.error(`getCellularRxBytes error, ${JSON.stringify(error)}`);
- return;
- }
- console.info(`getCellularRxBytes success, ${JSON.stringify(stats)}`);
- });
statistics.getCellularRxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getCellularRxBytes(): Promise<number>
获取当前已处于连接状态的蜂窝网络对应的网卡从最近一次开机开始至接口调用时刻的下行流量总和（单位：字节）。使用Promise异步回调。
说明
本接口建议在蜂窝网络处于连接状态时调用，否则会抛出2103012错误码。
系统能力：SystemCapability.Communication.NetManager.Core
返回值：
| 类型 | 说明 |
|---|---|
| Promise<number> | Promise对象。返回指定网卡从最近一次开机开始至接口调用时刻的下行流量总和（单位：字节）。 |
错误码：
以下错误码的详细介绍参见流量管理错误码。
| 错误码ID | 错误信息 |
|---|---|
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
| 2103012 | Failed to obtain the NIC name. |
示例：
- import { statistics } from '@kit.NetworkKit';
-
- statistics.getCellularRxBytes().then((stats: number) => {
- console.info('getCellularRxBytes success', JSON.stringify(stats));
- }).catch((error: Error) => {
- console.error('getCellularRxBytes error', JSON.stringify(error));
- });
statistics.getCellularTxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getCellularTxBytes(callback: AsyncCallback<number>): void
获取当前已处于连接状态的蜂窝网络对应的网卡从最近一次开机开始至接口调用时刻的上行流量总和（单位：字节）。使用callback异步回调。
说明
本接口建议在蜂窝网络处于连接状态时调用，否则会抛出2103012错误码。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| callback | AsyncCallback<number> | 是 | 回调函数。当成功获取到流量数据时，error为undefined，否则为错误对象。 |
错误码：
以下错误码的详细介绍参见流量管理错误码。
| 错误码ID | 错误信息 |
|---|---|
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
| 2103012 | Failed to obtain the NIC name. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { statistics } from '@kit.NetworkKit';
-
- statistics.getCellularTxBytes((error: BusinessError, stats: number) => {
- if (error) {
- console.error(`getCellularTxBytes error, ${JSON.stringify(error)}`);
- return;
- }
- console.info(`getCellularTxBytes success, ${JSON.stringify(stats)}`);
- });
statistics.getCellularTxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getCellularTxBytes(): Promise<number>
获取当前已处于连接状态的蜂窝网络对应的网卡从最近一次开机开始至接口调用时刻的上行流量总和（单位：字节）。使用Promise异步回调。
说明
本接口建议在蜂窝网络处于连接状态时调用，否则会抛出2103012错误码。
系统能力：SystemCapability.Communication.NetManager.Core
返回值：
| 类型 | 说明 |
|---|---|
| Promise<number> | Promise对象。返回从最近一次开机开始到现在，蜂窝上所消耗的上行流量总和（单位：字节）。 |
错误码：
以下错误码的详细介绍参见流量管理错误码。
| 错误码ID | 错误信息 |
|---|---|
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
| 2103012 | Failed to obtain the NIC name. |
示例：
- import { statistics } from '@kit.NetworkKit';
-
- statistics.getCellularTxBytes().then((stats: number) => {
- console.info('getCellularTxBytes success', JSON.stringify(stats));
- }).catch((error: Error) => {
- console.error('getCellularTxBytes error', JSON.stringify(error));
- });
statistics.getAllRxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getAllRxBytes(callback: AsyncCallback<number>): void
获取所有网卡从最近一次开机开始至接口调用时刻的下行流量总和（单位：字节）。使用callback异步回调。
元服务API： 从API version 15开始，该接口支持在元服务中使用。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| callback | AsyncCallback<number> | 是 | 回调函数。当成功获取到流量数据时，error为undefined，否则为错误对象。 |
错误码：
以下错误码的详细介绍参见流量管理错误码。
| 错误码ID | 错误信息 |
|---|---|
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
示例：
- import { statistics } from '@kit.NetworkKit';
- import { BusinessError } from '@kit.BasicServicesKit';
-
- statistics.getAllRxBytes((error: BusinessError, stats: number) => {
- if (error) {
- console.error(JSON.stringify(error));
- return;
- }
- console.info(JSON.stringify(stats));
- });
statistics.getAllRxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getAllRxBytes(): Promise<number>
获取所有网卡从最近一次开机开始至接口调用时刻的下行流量总和（单位：字节）。使用Promise异步回调。
元服务API： 从API version 15开始，该接口支持在元服务中使用。
系统能力：SystemCapability.Communication.NetManager.Core
返回值：
| 类型 | 说明 |
|---|---|
| Promise<number> | Promise对象。返回所有网卡从最近一次开机开始到现在的下行流量总和（单位：字节）。 |
错误码：
以下错误码的详细介绍参见流量管理错误码。
| 错误码ID | 错误信息 |
|---|---|
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
示例：
- import { statistics } from '@kit.NetworkKit';
-
- statistics.getAllRxBytes().then((stats: number) => {
- console.info('getAllRxBytes success', JSON.stringify(stats));
- }).catch((error: Error) => {
- console.error('getAllRxBytes error', JSON.stringify(error));
- });
statistics.getAllTxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getAllTxBytes(callback: AsyncCallback<number>): void
获取所有网卡从最近一次开机开始至接口调用时刻的上行流量总和（单位：字节）。使用callback异步回调。
元服务API： 从API version 15开始，该接口支持在元服务中使用。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| callback | AsyncCallback<number> | 是 | 回调函数。当成功获取到流量数据时，error为undefined，否则为错误对象。 |
错误码：
以下错误码的详细介绍参见流量管理错误码。
| 错误码ID | 错误信息 |
|---|---|
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { statistics } from '@kit.NetworkKit';
-
- statistics.getAllTxBytes((error: BusinessError, stats: number) => {
- if (error) {
- console.error(JSON.stringify(error));
- return;
- }
- console.info(JSON.stringify(stats));
- });
statistics.getAllTxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getAllTxBytes(): Promise<number>
获取所有网卡从最近一次开机开始至接口调用时刻的上行流量总和（单位：字节）。使用Promise异步回调。
元服务API： 从API version 15开始，该接口支持在元服务中使用。
系统能力：SystemCapability.Communication.NetManager.Core
返回值：
| 类型 | 说明 |
|---|---|
| Promise<number> | 以Promise 形式返回获取结果。返回所有网卡实时上行流量（单位：字节）。 |
错误码：
以下错误码的详细介绍参见流量管理错误码。
| 错误码ID | 错误信息 |
|---|---|
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
示例：
- import { statistics } from '@kit.NetworkKit';
-
- statistics.getAllTxBytes().then((stats: number) => {
- console.info(JSON.stringify(stats));
- });
statistics.getUidRxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getUidRxBytes(uid: number, callback: AsyncCallback<number>): void
获取指定应用从最近一次开机开始至接口调用时刻的下行流量总和（单位：字节）。使用callback异步回调。
说明
若重启后该应用未产生流量消耗，则会抛出2103005错误码。
需要权限：
- API版本26.0.0之前：N/A
- API版本26.0.0+：ohos.permission.GET_NETWORK_STATS（仅当参数uid数值与接口调用方uid不同时需要申请，即查询非自身应用流量数据时需要申请）
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| uid | number | 是 | 指定查询的应用 uid。 |
| callback | AsyncCallback<number> | 是 | 回调函数。当成功获取到流量数据时，error为undefined，否则为错误对象。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 201 | Permission denied. 适用版本：26.0.0+ |
| 401 | Parameter error. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { statistics } from '@kit.NetworkKit';
-
- let uid = 123456789; // uid示例，请传入正确的uid
- statistics.getUidRxBytes(uid, (error: BusinessError, stats: number) => {
- if (error) {
- console.error(JSON.stringify(error));
- return;
- }
- console.info(JSON.stringify(stats));
- });
statistics.getUidRxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getUidRxBytes(uid: number): Promise<number>
获取指定应用从最近一次开机开始至接口调用时刻的下行流量总和（单位：字节）。使用Promise异步回调。
说明
若重启后该应用未产生流量消耗，则会抛出2103005错误码。
系统能力：SystemCapability.Communication.NetManager.Core
需要权限：
- API版本26.0.0之前：N/A
- API版本26.0.0+：ohos.permission.GET_NETWORK_STATS（仅当参数uid数值与接口调用方uid不同时需要申请，即查询非自身应用流量数据时需要申请）
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| uid | number | 是 | 指定查询的应用 uid。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise<number> | Promise对象。返回指定应用从最近一次开机开始到现在的下行流量总和（单位：字节）。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 201 | Permission denied. 适用版本：26.0.0+ |
| 401 | Parameter error. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
示例：
- import { statistics } from '@kit.NetworkKit';
-
- let uid = 123456789; // uid示例，请传入正确的uid
- statistics.getUidRxBytes(uid).then((stats: number) => {
- console.info(JSON.stringify(stats));
- });
statistics.getUidTxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getUidTxBytes(uid: number, callback: AsyncCallback<number>): void
获取指定应用从最近一次开机开始至接口调用时刻的上行流量总和（单位：字节）。使用callback异步回调。
说明
若重启后该应用未产生流量消耗，则会抛出2103005错误码。
系统能力：SystemCapability.Communication.NetManager.Core
需要权限：
- API版本26.0.0之前：N/A
- API版本26.0.0+：ohos.permission.GET_NETWORK_STATS（仅当参数uid数值与接口调用方uid不同时需要申请，即查询非自身应用流量数据时需要申请）
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| uid | number | 是 | 指定查询的应用 uid。 |
| callback | AsyncCallback<number> | 是 | 回调函数。当成功获取应用实时上行流量时，error为undefined，stats为获取到的应用上行流量（单位：字节）；否则为错误对象。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 201 | Permission denied. 适用版本：26.0.0+ |
| 401 | Parameter error. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { statistics } from '@kit.NetworkKit';
-
- let uid = 123456789; // uid示例，请传入正确的uid
- statistics.getUidTxBytes(uid, (error: BusinessError, stats: number) => {
- if (error) {
- console.error(JSON.stringify(error));
- return;
- }
- console.info(JSON.stringify(stats));
- });
statistics.getUidTxBytes
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getUidTxBytes(uid: number): Promise<number>
获取指定应用从最近一次开机开始至接口调用时刻的上行流量总和（单位：字节）。使用Promise异步回调。
说明
若重启后该应用未产生流量消耗，则会抛出2103005错误码。
系统能力：SystemCapability.Communication.NetManager.Core
需要权限：
- API版本26.0.0之前：N/A
- API版本26.0.0+：ohos.permission.GET_NETWORK_STATS（仅当参数uid数值与接口调用方uid不同时需要申请，即查询非自身应用流量数据时需要申请）
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| uid | number | 是 | 指定查询的应用 uid。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise<number> | Promise对象。返回指定应用从最近一次开机开始至接口调用时刻的上行流量总和（单位：字节）。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 201 | Permission denied. 适用版本：26.0.0+ |
| 401 | Parameter error. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103005 | Failed to read the system map. |
| 2103011 | Failed to create a system map. |
示例：
- import { statistics } from '@kit.NetworkKit';
-
- let uid = 123456789; // uid示例，请传入正确的uid
- statistics.getUidTxBytes(uid).then((stats: number) => {
- console.info(JSON.stringify(stats));
- });
statistics.getSockfdRxBytes11+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getSockfdRxBytes(sockfd: number, callback: AsyncCallback<number>): void
获取指定Socket的下行流量（单位：字节）。使用callback异步回调。
说明
推荐在Socket连接时使用，否则Socket已经关闭后无法查询到对应流量数据。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sockfd | number | 是 | 指定查询的Socket的FD(file description)。 |
| callback | AsyncCallback<number> | 是 | 回调函数。当成功获取Socket的下行流量时，error为undefined，否则为错误对象。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. |
| 2100001 | Invalid parameter value. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { statistics } from '@kit.NetworkKit';
-
- let sockfd = 50; // 实际开发中需要先根据自己创建的Socket获取到。
- statistics.getSockfdRxBytes(sockfd, (error: BusinessError, stats: number) => {
- if (error) {
- console.error(JSON.stringify(error));
- return;
- }
- console.info(JSON.stringify(stats));
- });
statistics.getSockfdRxBytes11+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getSockfdRxBytes(sockfd: number): Promise<number>
获取指定Socket的下行流量（单位：字节）。使用Promise异步回调。
说明
推荐在Socket连接时使用，否则Socket已经关闭后无法查询到对应流量数据。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sockfd | number | 是 | 指定查询的Socket的FD(file description)。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise<number> | Promise对象。返回该Socket的下行流量（单位：字节）。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. |
| 2100001 | Invalid parameter value. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { statistics } from '@kit.NetworkKit';
-
- let sockfd = 50; // 实际开发中需要先根据自己创建的Socket获取到。
- statistics.getSockfdRxBytes(sockfd).then((stats: number) => {
- console.info(JSON.stringify(stats));
- }).catch((err: BusinessError) => {
- console.error(JSON.stringify(err));
- });
statistics.getSockfdTxBytes11+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getSockfdTxBytes(sockfd: number, callback: AsyncCallback<number>): void
获取指定Socket的上行流量（单位：字节）。使用callback异步回调。
说明
推荐在Socket连接时使用，否则Socket已经关闭后无法查询到对应流量数据。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sockfd | number | 是 | 指定查询的Socket的FD(file description)。 |
| callback | AsyncCallback<number> | 是 | 回调函数。当成功获取Socket的上行流量时，error为undefined，否则为错误对象。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. |
| 2100001 | Invalid parameter value. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { statistics } from '@kit.NetworkKit';
-
- let sockfd = 50; // 实际开发中需要先根据自己创建的Socket获取到。
- statistics.getSockfdTxBytes(sockfd, (error: BusinessError, stats: number) => {
- if (error) {
- console.error(JSON.stringify(error));
- return;
- }
- console.info(JSON.stringify(stats));
- });
statistics.getSockfdTxBytes11+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
getSockfdTxBytes(sockfd: number): Promise<number>
获取指定Socket的上行流量（单位：字节）。使用Promise异步回调。
说明
推荐在Socket连接时使用，否则Socket已经关闭后无法查询到对应流量数据。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sockfd | number | 是 | 指定查询的Socket的FD(file description)。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise<number> | Promise对象。返回该Socket的上行流量（单位：字节）。 |
错误码：
| 错误码ID | 错误信息 |
|---|---|
| 401 | Parameter error. |
| 2100001 | Invalid parameter value. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { statistics } from '@kit.NetworkKit';
-
- let sockfd = 50; // 实际开发中需要先根据自己创建的Socket获取到。
- statistics.getSockfdTxBytes(sockfd).then((stats: number) => {
- console.info(JSON.stringify(stats));
- }).catch((err: BusinessError) => {
- console.error(JSON.stringify(err));
- });
statistics.getSelfTrafficStats22+
Phone22+PC/2in122+Tablet22+TV22+Wearable22+
getSelfTrafficStats(networkInfo: NetworkInfo): Promise<NetStatsInfo>
获取指定时间段内，本应用在指定网络中的流量使用情况。使用Promise异步回调。
说明
-
当前只支持获取蜂窝和Wi-Fi流量使用情况。
- 当前只支持获取31天之内的流量使用情况，如果参数中传入的时间戳早于当前系统时间31天，会返回错误码2103019。
- 本接口会有一定耗时，调用时请注意切勿频繁调用。
系统能力：SystemCapability.Communication.NetManager.Core
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| networkInfo | NetworkInfo | 是 | 指定查询的网络信息。 |
返回值：
| 类型 | 说明 |
|---|---|
| Promise<NetStatsInfo> | Promise对象，返回应用历史流量统计信息。 |
错误码：
以下错误码的详细介绍参见流量管理错误码。
| 错误码ID | 错误信息 |
|---|---|
| 2100001 | Invalid parameter value. |
| 2100002 | Failed to connect to the service. |
| 2100003 | System internal error. |
| 2103017 | Failed to read the database. |
| 2103019 | The timestamp in param is invalid. |
示例：
- import { BusinessError } from '@kit.BasicServicesKit';
- import { connection, statistics } from '@kit.NetworkKit';
-
- let networkInfo: statistics.NetworkInfo = {
- type: connection.NetBearType.BEARER_CELLULAR,
- startTime: Math.floor(Date.now() / 1000) - 86400 * 31,
- endTime: Math.floor(Date.now() / 1000),
- simId: 1,
- }
-
- statistics.getSelfTrafficStats(networkInfo).then((stats: statistics.NetStatsInfo) => {
- console.info('getSelfTrafficStats success : ' + JSON.stringify(stats));
- }).catch((err: BusinessError) => {
- console.error('getSelfTrafficStats error. code: ' + `${err.code}` + ', message: ' + `${err.message}`);
- });
NetBearType12+
Phone12+PC/2in113+Tablet12+TV19+Wearable18+
type NetBearType = connection.NetBearType
网络类型。
系统能力：SystemCapability.Communication.NetManager.Core
| 类型 | 说明 |
|---|---|
| connection.NetBearType | 枚举网络类型。 |
NetworkInfo22+
网络信息。
系统能力：SystemCapability.Communication.NetManager.Core
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| type | NetBearType | 否 | 否 | 网络类型。 注意： 当type为蜂窝网络时，需指定simId字段。 |
| startTime | number | 否 | 否 | 开始时间戳（单位：秒）。 |
| endTime | number | 否 | 否 | 结束时间戳（单位：秒）。 |
| simId | number | 否 | 是 | SIM卡ID。默认值为uint32_t类型最大值。 注意： 当type为蜂窝网络时，需指定本字段。 |
NetStatsInfo22+
获取的历史流量信息。
系统能力：SystemCapability.Communication.NetManager.Core
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| rxBytes | number | 否 | 否 | 流量下行数据（单位：字节）。 |
| txBytes | number | 否 | 否 | 流量上行数据（单位：字节）。 |
| rxPackets | number | 否 | 否 | 流量下行包个数。 |
| txPackets | number | 否 | 否 | 流量上行包个数。 |
在 开发与测试 开放能力API 中进行搜索
请输入您想要搜索的关键词