@ohos.net.policy (网络策略管理)

网络策略管理通过对用户使用数据流量进行控制管理，采用防火墙技术实现网络策略的管理。

说明：

本模块首批接口从 API version 10 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

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

policy.setBackgroundAllowed¹⁰⁺

setBackgroundAllowed(isAllowed: boolean, callback: AsyncCallback<void>): void

设置是否允许后台应用访问网络，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.setBackgroundAllowed(true, (error: BusinessError) => {
  console.log(JSON.stringify(error));
});

policy.setBackgroundAllowed¹⁰⁺

setBackgroundAllowed(isAllowed: boolean): Promise<void>

设置是否允许后台应用访问网络，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

返回值：

示例：

import { BusinessError } from '@ohos.base';
policy.setBackgroundAllowed(true).then(() => {
  console.log("setBackgroundAllowed success");
}).catch((error: BusinessError) => {
  console.log(JSON.stringify(error));
});

policy.isBackgroundAllowed¹⁰⁺

isBackgroundAllowed(callback: AsyncCallback<boolean>): void

获取当前应用是否允许后台访问网络，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.isBackgroundAllowed((error: BusinessError, data: boolean) => {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

policy.isBackgroundAllowed¹⁰⁺

isBackgroundAllowed(): Promise<boolean>;

获取当前应用是否允许后台访问网络，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .isBackgroundAllowed()
  .then((data: boolean) => {
    console.log(JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.setPolicyByUid¹⁰⁺

setPolicyByUid(uid: number, policy: NetUidPolicy, callback: AsyncCallback<void>): void

设置对应 uid 应用是否能够访问计量网络的策略，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.setPolicyByUid(11111, policy.NetUidPolicy.NET_POLICY_NONE, (error: BusinessError) => {
  console.log(JSON.stringify(error));
});

policy.setPolicyByUid¹⁰⁺

setPolicyByUid(uid: number, policy: NetUidPolicy): Promise<void>;

设置对应 uid 应用是否能够访问计量网络的策略，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .setPolicyByUid(11111, policy.NetUidPolicy.NET_POLICY_NONE)
  .then(() => {
    console.log('setPolicyByUid success');
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.getPolicyByUid¹⁰⁺

getPolicyByUid(uid: number, callback: AsyncCallback<NetUidPolicy>): void

通过应用 uid 获取对应访问网络策略，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.getPolicyByUid(11111, (error: BusinessError, data: policy.NetUidPolicy) => {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

policy.getPolicyByUid¹⁰⁺

getPolicyByUid(uid: number): Promise<NetUidPolicy>;

通过应用 uid 获取对应访问网络策略，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .getPolicyByUid(11111)
  .then((data: policy.NetUidPolicy) => {
    console.log(JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.getUidsByPolicy¹⁰⁺

getUidsByPolicy(policy: NetUidPolicy, callback: AsyncCallback<Array<number>>): void

通过策略获取跟策略匹配的所有 uid，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.getUidsByPolicy(11111, (error: BusinessError, data: number[]) => {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

policy.getUidsByPolicy¹⁰⁺

getUidsByPolicy(policy: NetUidPolicy): Promise<Array<number>>;

通过策略获取跟策略匹配的所有 uid，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .getUidsByPolicy(11111)
  .then((data: object) => {
    console.log(JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.getNetQuotaPolicies¹⁰⁺

getNetQuotaPolicies(callback: AsyncCallback<Array<NetQuotaPolicy>>): void

获取计量网络策略，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.getNetQuotaPolicies((error: BusinessError, data: policy.NetQuotaPolicy[]) => {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

policy.getNetQuotaPolicies¹⁰⁺

getNetQuotaPolicies(): Promise<Array<NetQuotaPolicy>>;

获取计量网络策略，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .getNetQuotaPolicies()
  .then((data: policy.NetQuotaPolicy[]) => {
    console.log(JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.setNetQuotaPolicies¹⁰⁺

setNetQuotaPolicies(quotaPolicies: Array<NetQuotaPolicy>, callback: AsyncCallback<void>): void

设置计量网络策略，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

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

let netQuotaPolicyList: Array<policy.NetQuotaPolicy> = [];
let netquotapolicy: policy.NetQuotaPolicy = {
  networkMatchRule: {
    netType: connection.NetBearType.BEARER_CELLULAR,
    identity: '',
    simId: '1'
  },
  quotaPolicy: {
    periodDuration: 'M1',
    warningBytes: 40000,
    limitBytes: 50000,
    metered: true,
    limitAction: policy.LimitAction.LIMIT_ACTION_NONE
  }
}
netQuotaPolicyList.push(netquotapolicy);

policy.setNetQuotaPolicies(netQuotaPolicyList, (error: BusinessError) => {
  console.log(JSON.stringify(error));
});

policy.setNetQuotaPolicies¹⁰⁺

setNetQuotaPolicies(quotaPolicies: Array<NetQuotaPolicy>): Promise<void>;

设置计量网络策略，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

返回值：

示例：

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

let netQuotaPolicyList: Array<policy.NetQuotaPolicy> = [];
let netquotapolicy: policy.NetQuotaPolicy = {
  networkMatchRule: {
    netType: connection.NetBearType.BEARER_CELLULAR,
    identity: '',
    simId: '1'
  },
  quotaPolicy: {
    periodDuration: 'M1',
    warningBytes: 40000,
    limitBytes: 50000,
    metered: true,
    limitAction: policy.LimitAction.LIMIT_ACTION_NONE
  }
}
netQuotaPolicyList.push(netquotapolicy);

policy
  .setNetQuotaPolicies(netQuotaPolicyList)
  .then(() => {
    console.log('setNetQuotaPolicies success');
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.isUidNetAllowed¹⁰⁺

isUidNetAllowed(uid: number, isMetered: boolean, callback: AsyncCallback<boolean>): void

判断对应 uid 能否访问计量或非计量网络，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.isUidNetAllowed(11111, true, (error: BusinessError, data: boolean) => {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

policy.isUidNetAllowed¹⁰⁺

isUidNetAllowed(uid: number, isMetered: boolean): Promise<boolean>;

判断对应 uid 能否访问计量或非计量网络，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .isUidNetAllowed(11111, true)
  .then((data: boolean) => {
    console.log(JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.isUidNetAllowed¹⁰⁺

isUidNetAllowed(uid: number, iface: string, callback: AsyncCallback<boolean>): void

获取对应 uid 能否访问指定的 iface 的网络，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.isUidNetAllowed(11111, 'wlan0', (error: BusinessError, data: boolean) => {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

policy.isUidNetAllowed¹⁰⁺

isUidNetAllowed(uid: number, iface: string): Promise<boolean>;

获取对应 uid 能否访问指定的 iface 的网络，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .isUidNetAllowed(11111, 'wlan0')
  .then((data: boolean) => {
    console.log(JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.setDeviceIdleTrustlist¹⁰⁺

setDeviceIdleTrustlist(uids: Array<number>, isAllowed: boolean, callback: AsyncCallback<void>): void

设置多个 uid 是否在休眠防火墙的白名单，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.setDeviceIdleTrustlist([11111, 22222], true, (error: BusinessError) => {
  console.log(JSON.stringify(error));
});

policy.setDeviceIdleTrustlist¹⁰⁺

setDeviceIdleTrustlist(uids: Array<number>, isAllowed: boolean): Promise<void>;

设置多个 uid 是否在休眠防火墙的白名单，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .setDeviceIdleTrustlist([11111, 22222], true)
  .then(() => {
    console.log('setDeviceIdleTrustlist success');
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.getDeviceIdleTrustlist¹⁰⁺

getDeviceIdleTrustlist(callback: AsyncCallback<Array<number>>): void

获取休眠模式白名单所包含的 uid，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.getDeviceIdleTrustlist((error: BusinessError, data: number[]) => {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

policy.getDeviceIdleTrustlist¹⁰⁺

getDeviceIdleTrustlist(): Promise<Array<number>>;

获取休眠模式白名单所包含的 uid，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .getDeviceIdleTrustlist()
  .then((data: number[]) => {
    console.log(JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.getBackgroundPolicyByUid¹⁰⁺

getBackgroundPolicyByUid(uid: number, callback: AsyncCallback<NetBackgroundPolicy>): void

获取指定 uid 是否能访问后台网络，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.getBackgroundPolicyByUid(11111, (error: BusinessError, data: policy.NetBackgroundPolicy) => {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

policy.getBackgroundPolicyByUid¹⁰⁺

getBackgroundPolicyByUid(uid: number): Promise<NetBackgroundPolicy>;

获取指定 uid 能否访问后台网络，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .getBackgroundPolicyByUid(11111)
  .then((data: policy.NetBackgroundPolicy) => {
    console.log(JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.resetPolicies¹⁰⁺

resetPolicies(simId: string, callback: AsyncCallback<void>): void

重置对应 sim 卡 id 的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.resetPolicies('1', (error: BusinessError) => {
  console.log(JSON.stringify(error));
});

policy.resetPolicies¹⁰⁺

resetPolicies(simId: string): Promise<void>;

重置对应 sim 卡 id 的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .resetPolicies('1')
  .then(() => {
    console.log('resetPolicies success');
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.updateRemindPolicy¹⁰⁺

updateRemindPolicy(netType: NetBearType, simId: string, remindType: RemindType, callback: AsyncCallback<void>): void

更新提醒策略，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import connection from '@ohos.net.connection';
import { BusinessError } from '@ohos.base';
policy.updateRemindPolicy(
  connection.NetBearType.BEARER_CELLULAR,
  '1',
  policy.RemindType.REMIND_TYPE_WARNING,
  (error: BusinessError) => {
    console.log(JSON.stringify(error));
  }
);

policy.updateRemindPolicy¹⁰⁺

updateRemindPolicy(netType: NetBearType, simId: string, remindType: RemindType): Promise<void>;

更新提醒策略，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

返回值：

错误码：

示例：

import connection from '@ohos.net.connection';
import { BusinessError } from '@ohos.base';
policy
  .updateRemindPolicy(
    connection.NetBearType.BEARER_CELLULAR,
    '1',
    policy.RemindType.REMIND_TYPE_WARNING
  )
  .then(() => {
    console.log('updateRemindPolicy success');
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.setPowerSaveTrustlist¹⁰⁺

setPowerSaveTrustlist(uids: Array<number>, isAllowed: boolean, callback: AsyncCallback<void>): void

设置指定 uid 应用是否在省电防火墙的白名单，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.setPowerSaveTrustlist([11111, 22222], true, (error: BusinessError) => {
  console.log(JSON.stringify(error));
});

policy.setPowerSaveTrustlist¹⁰⁺

setPowerSaveTrustlist(uids: Array<number>, isAllowed: boolean): Promise<void>;

设置指定 uid 应用是否在省电防火墙的白名单，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .setPowerSaveTrustlist([11111, 22222], true)
  .then(() => {
    console.log('setPowerSaveTrustlist success');
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.getPowerSaveTrustlist¹⁰⁺

getPowerSaveTrustlist(callback: AsyncCallback<Array<number>>): void

获取省电模式白名单所包含的 uid 数组，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy.getPowerSaveTrustlist((error: BusinessError, data: number[]) => {
  console.log(JSON.stringify(error));
  console.log(JSON.stringify(data));
});

policy.getPowerSaveTrustlist¹⁰⁺

getPowerSaveTrustlist(): Promise<Array<number>>;

获取休眠模式白名单所包含的 uid 数组，使用 Promise 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

返回值：

错误码：

示例：

import { BusinessError } from '@ohos.base';
policy
  .getPowerSaveTrustlist()
  .then((data: number[]) => {
    console.log(JSON.stringify(data));
  })
  .catch((error: BusinessError) => {
    console.log(JSON.stringify(error));
  });

policy.on

网络策略的句柄。

on('netUidPolicyChange')¹⁰⁺

on(type: "netUidPolicyChange", callback: Callback<{ uid: number, policy: NetUidPolicy }>): void

注册 policy 发生改变时的回调，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

import policy from '@ohos.net.policy';
interface Data {
  uid: number,
  policy: policy.NetUidPolicy
}
policy.on('netUidPolicyChange', (data: Data) => {
  console.log('on netUidPolicyChange: ' + JSON.stringify(data));
});

off('netUidPolicyChange')¹⁰⁺

off(type: "netUidPolicyChange", callback?: Callback<{ uid: number, policy: NetUidPolicy }>): void

注销 policy 发生改变时的回调，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

let callback = (data: object) => {
  console.log('on netUidPolicyChange, data:' + JSON.stringify(data));
};
policy.on('netUidPolicyChange', callback);
policy.off('netUidPolicyChange', callback);

on('netUidRuleChange')¹⁰⁺

on(type: "netUidRuleChange", callback: Callback<{ uid: number, rule: NetUidRule }>): void

注册 rule 发生改变时的回调，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

policy.on('netUidRuleChange', (data: object) => {
  console.log('on netUidRuleChange: ' + JSON.stringify(data));
});

off('netUidRuleChange')¹⁰⁺

off(type: "netUidRuleChange", callback?: Callback<{ uid: number, rule: NetUidRule }>): void

注销 rule 发生改变时的回调，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

let callback = (data: object) => {
  console.log('on netUidRuleChange, data:' + JSON.stringify(data));
};
policy.on('netUidRuleChange', callback);
policy.off('netUidRuleChange', callback);

on('netMeteredIfacesChange')¹⁰⁺

on(type: "netMeteredIfacesChange", callback: Callback<Array<string>>): void

注册计量 iface 发生改变时的回调，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

policy.on('netMeteredIfacesChange', (data: string[]) => {
  console.log('on netMeteredIfacesChange: ' + JSON.stringify(data));
});

off('netMeteredIfacesChange')¹⁰⁺

off(type: "netMeteredIfacesChange", callback?: Callback<Array<string>>): void

注销计量 iface 发生改变时的回调，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

let callback = (data: string[]) => {
  console.log('on netMeteredIfacesChange, data:' + JSON.stringify(data));
};
policy.on('netMeteredIfacesChange', callback);
policy.off('netMeteredIfacesChange', callback);

on('netQuotaPolicyChange')¹⁰⁺

on(type: "netQuotaPolicyChange", callback: Callback<Array<NetQuotaPolicy>>): void

注册计量网络策略发生改变时的回调，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

policy.on('netQuotaPolicyChange', (data: policy.NetQuotaPolicy[]) => {
  console.log('on netQuotaPolicyChange: ' + JSON.stringify(data));
});

off('netQuotaPolicyChange')¹⁰⁺

off(type: "netQuotaPolicyChange", callback?: Callback<Array<NetQuotaPolicy>>): void

注销计量网络策略发生改变时的回调，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

policy.on('netQuotaPolicyChange', (data: Array<policy.NetQuotaPolicy>) => {
  console.log('on netQuotaPolicyChange, data:' + JSON.stringify(data));
});
policy.off('netQuotaPolicyChange', (data: Array<policy.NetQuotaPolicy>) => {
  console.log('on netQuotaPolicyChange, data:' + JSON.stringify(data));
});

on('netBackgroundPolicyChange')¹⁰⁺

on(type: "netBackgroundPolicyChange", callback: Callback<boolean>): void

注册后台网络策略发生改变时的回调，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

policy.on('netBackgroundPolicyChange', (data: boolean) => {
  console.log('on netBackgroundPolicyChange: ' + JSON.stringify(data));
});

off('netBackgroundPolicyChange')¹⁰⁺

off(type: "netBackgroundPolicyChange", callback?: Callback<boolean>): void

注销后台网络策略发生改变时的回调，使用 callback 方式作为异步方法。

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

需要权限：ohos.permission.MANAGE_NET_STRATEGY

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

参数：

错误码：

示例：

let callback = (data: boolean) => {
  console.log('on netBackgroundPolicyChange, data:' + JSON.stringify(data));
};
policy.on('netBackgroundPolicyChange', callback);
policy.off('netBackgroundPolicyChange', callback);

NetBackgroundPolicy¹⁰⁺

后台网络策略。

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

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

NetQuotaPolicy¹⁰⁺

计量网络策略。

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

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

NetworkMatchRule¹⁰⁺

网络标识，用来确定设置哪一个网络

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

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

QuotaPolicy¹⁰⁺

计量网络策略

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

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

LimitAction¹⁰⁺

限制动作。

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

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

NetUidRule¹⁰⁺

计量网络规则。

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

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

RemindType¹⁰⁺

提醒类型。

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

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

NetUidPolicy¹⁰⁺

应用对应的网络策略。

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

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