Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
410df270
D
Docs
项目概览
OpenHarmony
/
Docs
大约 1 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
410df270
编写于
2月 08, 2023
作者:
Z
zhanghaifeng
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Description: fix comments
Signed-off-by:
N
zhanghaifeng
<
zhanghaifeng11@huawei.com
>
上级
9d4394f1
变更
8
隐藏空白更改
内联
并排
Showing
8 changed file
with
46 addition
and
102 deletion
+46
-102
zh-cn/application-dev/connectivity/net-connection-manager.md
zh-cn/application-dev/connectivity/net-connection-manager.md
+3
-22
zh-cn/application-dev/connectivity/net-ethernet.md
zh-cn/application-dev/connectivity/net-ethernet.md
+4
-9
zh-cn/application-dev/connectivity/net-policy-management.md
zh-cn/application-dev/connectivity/net-policy-management.md
+3
-22
zh-cn/application-dev/connectivity/net-sharing.md
zh-cn/application-dev/connectivity/net-sharing.md
+3
-14
zh-cn/application-dev/connectivity/socket-connection.md
zh-cn/application-dev/connectivity/socket-connection.md
+1
-3
zh-cn/application-dev/reference/apis/js-apis-net-connection.md
.../application-dev/reference/apis/js-apis-net-connection.md
+7
-7
zh-cn/application-dev/reference/apis/js-apis-net-ethernet.md
zh-cn/application-dev/reference/apis/js-apis-net-ethernet.md
+2
-2
zh-cn/application-dev/reference/apis/js-apis-net-policy.md
zh-cn/application-dev/reference/apis/js-apis-net-policy.md
+23
-23
未找到文件。
zh-cn/application-dev/connectivity/net-connection-manager.md
浏览文件 @
410df270
...
...
@@ -4,7 +4,7 @@
网络连接管理提供管理网络一些基础能力,包括WiFi/蜂窝/Ethernet等多网络连接优先级管理、网络质量评估、订阅默认/指定网络连接状态变化、查询网络连接信息、DNS解析等功能。
> **说明:**
>
本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本
。
>
为了保证应用的运行效率,大部分API调用都是异步的,对于异步调用的API均提供了callback和Promise两种方式,以下示例均采用callback函数,更多方式可以查阅[API参考](../reference/apis/js-apis-net-connection.md)
。
## 基本概念
-
网络生产者:数据网络的提供方,比如WiFi、蜂窝、Ethernet等。
...
...
@@ -15,6 +15,7 @@
## 约束
-
开发语言:C++ JS
-
系统:linux内核
-
本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 场景介绍
网络连接管理的典型场景有:
...
...
@@ -25,48 +26,30 @@
以下分别介绍具体开发方式。
## 接口说明
完整的JS API说明以及实例代码请参考:
[
网络连接管理
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/apis/js-apis-net-connection.md
)
。
完整的JS API说明以及实例代码请参考:
[
网络连接管理
](
..
/reference/apis/js-apis-net-connection.md
)
。
| 类型 | 接口 | 功能说明 |
| ---- | ---- | ---- |
| ohos.net.connection | function getDefaultNet(callback: AsyncCallback
\<
NetHandle>): void; |获取一个含有默认网络的netId的NetHandle对象,使用callback回调 |
| ohos.net.connection | function getDefaultNet(): Promise
\<
NetHandle>; |获取一个含有默认网络的netId的NetHandle对象,使用Promise回调 |
| ohos.net.connection | function getGlobalHttpProxy
<sup>
10+
</sup>
(callback: AsyncCallback
\<
HttpProxy>): void;| 获取网络的全局代理设置,使用callback回调 |
| ohos.net.connection | function getGlobalHttpProxy
<sup>
10+
</sup>
(): Promise
\<
HttpProxy>;| 获取网络的全局代理设置,使用Promise回调 |
| ohos.net.connection | function setGlobalHttpProxy
<sup>
10+
</sup>
(httpProxy: HttpProxy, callback: AsyncCallback
<void>
): void;| 设置网络全局Http代理配置信息,使用callback回调 |
| ohos.net.connection | function setGlobalHttpProxy
<sup>
10+
</sup>
(httpProxy: HttpProxy): Promise
<void>
;| 设置网络全局Http代理配置信息,使用Promise回调 |
| ohos.net.connection | function getAppNet
<sup>
9+
</sup>
(callback: AsyncCallback
\<
NetHandle>): void;| 获取一个App绑定的包含了网络netId的NetHandle对象,使用callback回调 |
| ohos.net.connection | function getAppNet
<sup>
9+
</sup>
(): Promise
\<
NetHandle>;| 获取一个App绑定的包含了网络netId的NetHandle对象,使用Promise回调 |
| ohos.net.connection | function setAppNet
<sup>
9+
</sup>
(netHandle: NetHandle, callback: AsyncCallback
\<
void>): void;| 绑定App到指定网络,绑定后的App只能通过指定网络访问外网。使用callback回调 |
| ohos.net.connection | function setAppNet
<sup>
9+
</sup>
(netHandle: NetHandle): Promise
\<
void>;| 绑定App到指定网络,绑定后的App只能通过指定网络访问外网。使用Promise回调 |
| ohos.net.connection | function getDefaultNetSync
<sup>
9+
</sup>
(): NetHandle; |使用同步方法获取默认激活的数据网络。可以使用getNetCapabilities去获取网络的类型、拥有的能力等信息。|
| ohos.net.connection | function hasDefaultNet(callback: AsyncCallback
\<
boolean>): void; |查询是否有默认网络,使用callback回调 |
| ohos.net.connection | function hasDefaultNet(): Promise
\<
boolean>; |查询是否有默认网络,使用Promise回调 |
| ohos.net.connection | function getAllNets(callback: AsyncCallback
\<
Array
\<
NetHandle>>): void;| 获取所处于连接状态的网络的MetHandle对象列表,使用callback回调 |
| ohos.net.connection | function getAllNets(): Promise
\<
Array
\<
NetHandle>>;| 获取所有处于连接状态的网络的NetHandle对象列表,使用Promise回调 |
| ohos.net.connection | function getConnectionProperties(netHandle: NetHandle, callback: AsyncCallback
\<
ConnectionProperties>): void; |查询默认网络的链路信息,使用callback回调 |
| ohos.net.connection | function getConnectionProperties(netHandle: NetHandle): Promise
\<
ConnectionProperties>; |查询默认网络的链路信息,使用Promise回调 |
| ohos.net.connection | function getNetCapabilities(netHandle: NetHandle, callback: AsyncCallback
\<
NetCapabilities>): void; |查询默认网络的能力集信息,使用callback回调 |
| ohos.net.connection | function getNetCapabilities(netHandle: NetHandle): Promise
\<
NetCapabilities>; |查询默认网络的能力集信息,使用Promise回调 |
| ohos.net.connection | function isDefaultNetMetered
<sup>
9+
</sup>
(callback: AsyncCallback
<boolean>
): void; |检查当前网络上的数据流量使用是否被计量,使用callback方式作为异步方法 |
| ohos.net.connection | function isDefaultNetMetered
<sup>
9+
</sup>
(): Promise
<boolean>
; |检查当前网络上的数据流量使用是否被计量,使用Promise方式作为异步方法 |
| ohos.net.connection | function reportNetConnected(netHandle: NetHandle, callback: AsyncCallback
\<
void>): void;| 向网络管理报告网络处于可用状态,调用此接口说明应用程序认为网络的可用性(ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED)与网络管理不一致。使用callback回调 |
| ohos.net.connection | function reportNetConnected(netHandle: NetHandle): Promise
\<
void>;| 向网络管理报告网络处于可用状态,调用此接口说明应用程序认为网络的可用性(ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED)与网络管理不一致。使用Promise回调 |
| ohos.net.connection | function reportNetDisconnected(netHandle: NetHandle, callback: AsyncCallback
\<
void>): void;| 向网络管理报告网络处于不可用状态,调用此接口说明应用程序认为网络的可用性(ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED)与网络管理不一致。使用callback回调 |
| ohos.net.connection | function reportNetDisconnected(netHandle: NetHandle): Promise
\<
void>;| 向网络管理报告网络处于不可用状态,调用此接口说明应用程序认为网络的可用性(ohos.net.connection.NetCap.NET_CAPABILITY_VAILDATED)与网络管理不一致。使用Promise回调 |
| ohos.net.connection | function getAddressesByName(host: string, callback: AsyncCallback
\<
Array
\<
NetAddress>>): void; |使用对应网络解析域名,获取所有IP,使用callback回调 |
| ohos.net.connection | function getAddressesByName(host: string): Promise
\<
Array
\<
NetAddress>>; |使用默认网络解析域名,获取所有IP,使用Promise回调 |
| ohos.net.connection | function enableAirplaneMode(callback: AsyncCallback
\<
void>): void; | 设置网络为飞行模式,使用callback回调 |
| ohos.net.connection | function enableAirplaneMode(): Promise
\<
void>;|设置网络为飞行模式,使用Promise回调 |
| ohos.net.connection | function disableAirplaneMode(callback: AsyncCallback
\<
void>): void;| 关闭网络飞行模式,使用callback回调 |
| ohos.net.connection | function disableAirplaneMode(): Promise
\<
void>;| 关闭网络飞行模式,使用Promise回调 |
| ohos.net.connection | function createNetConnection(netSpecifier?: NetSpecifier, timeout?: number): NetConnection; | 返回一个NetConnection对象,netSpecifier指定关注的网络的各项特征,timeout是超时时间(单位是毫秒),netSpecifier是timeout的必要条件,两者都没有则表示关注默认网络 |
| ohos.net.connection.NetHandle | bindSocket(socketParam: TCPSocket
\|
UDPSocket, callback: AsyncCallback
\<
void>): void; | 将TCPSocket或UDPSockett绑定到当前网络,使用callback回调 |
| ohos.net.connection.NetHandle | bindSocket(socketParam: TCPSocket
\|
UDPSocket): Promise
\<
void>;| 将TCPSocket或UDPSockett绑定到当前网络,使用Promise回调 |
| ohos.net.connection.NetHandle | getAddressesByName(host: string, callback: AsyncCallback
\<
Array
\<
NetAddress>>): void; |使用默认网络解析域名,获取所有IP,使用callback回调 |
| ohos.net.connection.NetHandle | getAddressesByName(host: string): Promise
\<
Array
\<
NetAddress>>; |使用对应网络解析域名,获取所有IP,使用Promise回调 |
| ohos.net.connection.NetHandle | getAddressByName(host: string, callback: AsyncCallback
\<
NetAddress>): void; |使用对应网络解析域名,获取一个IP,调用callbac |
| ohos.net.connection.NetHandle | getAddressByName(host: string): Promise
\<
NetAddress>; |使用对应网络解析域名,获取一个IP,使用Promise回调 |
| ohos.net.connection.NetConnection | on(type: 'netAvailable', callback: Callback
\<
NetHandle>): void; |监听收到网络可用的事件 |
| ohos.net.connection.NetConnection | on(type: 'netCapabilitiesChange', callback: Callback
\<
{ netHandle: NetHandle, netCap: NetCapabilities }>): void; |监听网络能力变化的事件 |
| ohos.net.connection.NetConnection | on(type: 'netConnectionPropertiesChange', callback: Callback
\<
{ netHandle: NetHandle, connectionProperties: ConnectionProperties }>): void; |监听网络连接信息变化的事件 |
...
...
@@ -78,8 +61,6 @@
## 接收指定网络的状态变化通知
### 开发步骤
1.
从@ohos.net.connection.d.ts中导入connection命名空间。
2.
调用createNetConnection方法,指定网络能力、网络类型和超时时间(可选,如不传入代表默认网络;创建不同于默认网络时可通过指定这些参数完成),创建一个NetConnection对象。
...
...
zh-cn/application-dev/connectivity/net-ethernet.md
浏览文件 @
410df270
...
...
@@ -2,14 +2,15 @@
## 简介
以太网连接的功能是提供支持设备通过硬件接口,以插入网线的形式访问互联网的能力。
设备接入网线后,可以获取动态分配的IP地址,
xxx等一系列网络属性;也可以
通过静态模式,手动配置与获取设备的网络属性。
设备接入网线后,可以获取动态分配的IP地址,
子网掩码,Gateway,DNS等一系列网络属性;
通过静态模式,手动配置与获取设备的网络属性。
> **说明:**
>
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本
。
>
为了保证应用的运行效率,大部分API调用都是异步的,对于异步调用的API均提供了callback和Promise两种方式,以下示例均采用callback函数,更多方式可以查阅[API参考](../reference/apis/js-apis-net-ethernet.md)
。
## 约束
-
开发语言:C++ JS
-
系统:linux内核
-
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 场景介绍
以太网连接的典型场景有:
...
...
@@ -19,23 +20,17 @@
以下分别介绍具体开发方式。
## 接口说明
完整的JS API说明以及实例代码请参考:
[
以太网连接
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/apis/js-apis-net-ethernet.md
)
。
完整的JS API说明以及实例代码请参考:
[
以太网连接
](
..
/reference/apis/js-apis-net-ethernet.md
)
。
| 类型 | 接口 | 功能说明 |
| ---- | ---- | ---- |
| ohos.net.ethernet | function setIfaceConfig(iface: string, ic: InterfaceConfiguration, callback: AsyncCallback
\<
void>): void | 配置指定以太网的网络属性,iface为网口名称,ic为配置信息,调用callback |
| ohos.net.ethernet | function setIfaceConfig(iface: string, ic: InterfaceConfiguration): Promise
\<
boolean>; | 配置指定以太网的网络属性,iface为网口名称,ic为配置信息,返回promise |
| ohos.net.ethernet | function getIfaceConfig(iface: string, callback: AsyncCallback
\<
InterfaceConfiguration>): void | 获取指定以太网的网络属性,iface为网口名称,调用callback |
| ohos.net.ethernet | function getIfaceConfig(iface: string): Promise
\<
InterfaceConfiguration>; | 获取指定以太网的网络属性,iface为网口名称,返回promise |
| ohos.net.ethernet | function isIfaceActive(iface: string, callback: AsyncCallback
\<
number>): void | 判断指定网口是否已激活,iface为网卡名称(无参为是否有激活网口),调用callback |
| ohos.net.ethernet | function isIfaceActive(iface: string): Promise
\<
number>; | 判断指定网口是否已激活,iface为网卡名称(无参为是否有激活网口),返回promise |
| ohos.net.ethernet | function getAllActiveIfaces(callback: AsyncCallback
\<
Array
\<
string>>): void; | 获取所有活动的网络接口,调用callback |
| ohos.net.ethernet | function getAllActiveIfaces(): Promise
\<
Array
\<
string>>; | 获取所有活动的网络接口,返回promise |
## 以太网连接-DHCP模式
### 开发步骤
1.
设备通过硬件接口,插入网线。
2.
从@ohos.net.ethernet中导入ethernet命名空间。
3.
调用getAllActiveIfaces方法,获取所有激活的有线网卡名称,如:“eth0”,“eth1”。
...
...
zh-cn/application-dev/connectivity/net-policy-management.md
浏览文件 @
410df270
...
...
@@ -5,7 +5,7 @@
网络策略管理提供一些限制网络的基础能力,包括蜂窝网络策略、休眠/省电模式策略、后台网络策略、重置网络策略等功能。
> **说明:**
>
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本
。
>
为了保证应用的运行效率,大部分API调用都是异步的,对于异步调用的API均提供了callback和Promise两种方式,以下示例均采用callback函数,更多方式可以查阅[API参考](../reference/apis/js-apis-net-policy.md)
。
## 基本概念
...
...
@@ -19,6 +19,7 @@
-
开发语言:C++ JS
-
系统:linux内核
-
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 场景介绍
...
...
@@ -42,39 +43,22 @@
| 类型 | 接口 | 功能说明 |
| ---- | ---- | ---- |
| ohos.net.policy | function setBackgroundPolicy(isAllowed: boolean, callback: AsyncCallback
\<
void>): void |设置后台网络策略,使用callback方式作为异步方法 |
| ohos.net.policy | function setBackgroundPolicy(isAllowed: boolean): Promise
\<
void> |设置后台网络策略,使用Promise方式作为异步方法 |
| ohos.net.policy | function isBackgroundAllowed(callback: AsyncCallback
\<
boolean>): void; |获取后台网络策略,使用callback方式作为异步方法 |
| ohos.net.policy | function isBackgroundAllowed(): Promise
\<
boolean>; |获取后台网络策略,使用Promise方式作为异步方法 |
| ohos.net.policy | function setPolicyByUid(uid: number, policy: NetUidPolicy, callback: AsyncCallback
\<
void>): void; |设置对应uid应用的访问计量网络的策略,使用callback方式作为异步方法 |
| ohos.net.policy | function setPolicyByUid(uid: number, policy: NetUidPolicy): Promise
\<
void>;| 设置对应uid应用的访问计量网络的策略,使用Promise方式作为异步方法 |
| ohos.net.policy | function getPolicyByUid(uid: number, callback: AsyncCallback
\<
NetUidPolicy>): void;| 通过应用uid获取策略,使用callback方式作为异步方法 |
| ohos.net.policy | function getPolicyByUid(uid: number): Promise
\<
NetUidPolicy>; | 通过应用uid获取策略,使用Promise方式作为异步方法 |
| ohos.net.policy | function getUidsByPolicy(policy: NetUidPolicy, callback: AsyncCallback
\<
Array
\<
number>>): void; | 通过策略获取设置这一策略的应用uid数组,使用callback方式作为异步方法 |
| ohos.net.policy | function getUidsByPolicy(policy: NetUidPolicy): Promise
\<
Array
\<
number>>; | 通过策略获取设置这一策略的应用uid数组,使用Promise方式作为异步方法 |
| ohos.net.policy | function getNetQuotaPolicies(callback: AsyncCallback
\<
Array
\<
NetQuotaPolicy>>): void; |获取计量网络策略,使用callback方式作为异步方法 |
| ohos.net.policy | function getNetQuotaPolicies(): Promise
\<
Array
\<
NetQuotaPolicy>>; |获取计量网络策略,使用Promise方式作为异步方法 |
| ohos.net.policy | function setNetQuotaPolicies(quotaPolicies: Array
\<
NetQuotaPolicy>, callback: AsyncCallback
\<
void>): void; |设置计量网络策略,使用callback方式作为异步方法 |
| ohos.net.policy | function setNetQuotaPolicies(quotaPolicies: Array
\<
NetQuotaPolicy>): Promise
\<
void>; | 设置计量网络策略,使用Promise方式作为异步方法 |
| ohos.net.policy | function restoreAllPolicies(iccid: string, callback: AsyncCallback
\<
void>): void; | 重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略,使用callback方式作为异步方法 |
| ohos.net.policy | function restoreAllPolicies(iccid: string): Promise
\<
void>; | 重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略,使用Promise方式作为异步方法 |
| ohos.net.policy | function isUidNetAllowed(uid: number, isMetered: boolean, callback: AsyncCallback
\<
boolean>): void; | 获取对应uid能否访问计量或非计量网络,使用callback方式作为异步方法 |
| ohos.net.policy | function isUidNetAllowed(uid: number, isMetered: boolean): Promise
\<
boolean>; | 获取对应uid能否访问计量或非计量网络,使用Promise方式作为异步方法 |
| ohos.net.policy | function isUidNetAllowed(uid: number, iface: string, callback: AsyncCallback
\<
boolean>): void; | 获取对应uid能否访问指定的iface的网络,使用callback方式作为异步方法 |
| ohos.net.policy | function isUidNetAllowed(uid: number, iface: string): Promise
\<
boolean>; | 获取对应uid能否访问指定的iface的网络,使用Promise方式作为异步方法 |
| ohos.net.policy | function setDeviceIdleAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback
\<
void>): void; | 设置指定uid应用是否在休眠防火墙的白名单,使用callback方式作为异步方法 |
| ohos.net.policy | function setDeviceIdleAllowList(uid: number, isAllowed: boolean): Promise
\<
void>; | 设置指定uid应用是否在休眠防火墙的白名单,使用Promise方式作为异步方法 |
| ohos.net.policy | function getDeviceIdleAllowList(callback: AsyncCallback
\<
Array
\<
number>>): void; | 获取休眠模式白名单所包含的uid数组,使用callback方式作为异步方法 |
| ohos.net.policy | function getDeviceIdleAllowList(): Promise
\<
Array
\<
number>>; | 获取休眠模式白名单所包含的uid数组,使用Promise方式作为异步方法 |
| ohos.net.policy | function getBackgroundPolicyByUid(uid: number, callback: AsyncCallback
\<
NetBackgroundPolicy>): void; | 获取指定uid能否访问后台网络,使用callback方式作为异步方法 |
| ohos.net.policy | function getBackgroundPolicyByUid(uid: number): Promise
\<
NetBackgroundPolicy>; | 获取指定uid能否访问后台网络,使用Promise方式作为异步方法 |
| ohos.net.policy | function resetPolicies(iccid: string, callback: AsyncCallback
\<
void>): void; | 重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略,使用callback方式作为异步方法 |
| ohos.net.policy | function resetPolicies(iccid: string): Promise
\<
void>; | 重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略,使用Promise方式作为异步方法 |
| ohos.net.policy | function updateRemindPolicy(netType: NetBearType, iccid: string, remindType: RemindType, callback: AsyncCallback
\<
void>): void; | 更新提醒策略,使用callback方式作为异步方法 |
| ohos.net.policy | function updateRemindPolicy(netType: NetBearType, iccid: string, remindType: RemindType): Promise
\<
void>; | 更新提醒策略,使用Promise方式作为异步方法。 |
| ohos.net.policy | function setPowerSaveAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback
\<
void>): void; | 设置指定uid应用是否在省电防火墙的白名单,使用callback方式作为异步方法 |
| ohos.net.policy | function setPowerSaveAllowList(uid: number, isAllowed: boolean): Promise
\<
void>; | 设置指定uid应用是否在省电防火墙的白名单,使用Promise方式作为异步方法 |
| ohos.net.policy | function getPowerSaveAllowList(callback: AsyncCallback
\<
Array
\<
number>>): void; | 获取省电模式白名单所包含的uid数组,使用callback方式作为异步方法 |
| ohos.net.policy | function getPowerSaveAllowList(): Promise
\<
Array
\<
number>>; | 获取休眠模式白名单所包含的uid数组,使用Promise方式作为异步方法 |
| ohos.net.policy | function on(type: "netUidPolicyChange", callback: Callback
\<
{ uid: number, policy: NetUidPolicy }>): void; | 订阅policy发生改变时的回调,使用callback方式作为异步方法 |
| ohos.net.policy | function off(type: "netUidPolicyChange", callback: Callback
\<
{ uid: number, policy: NetUidPolicy }>): void; | 取消订阅policy发生改变时的回调,使用callback方式作为异步方法 |
| ohos.net.policy | function on(type: "netUidRuleChange", callback: Callback
\<
{ uid: number, rule: NetUidRule }>): void; | 订阅rule发生改变时的回调,使用callback方式作为异步方法 |
...
...
@@ -88,8 +72,6 @@
## 设置计量网络配额/获取已经设置的计量网络策略
### 开发步骤
1.
从@ohos.net.policy.d.ts中导入policy命名空间。
2.
调用setNetQuotaPolicies方法,设置计量网络策略。
...
...
@@ -121,8 +103,7 @@
limitBytes
:
Number
.
parseInt
(
this
.
limitBytes
),
// 是否为计量网络 true为计量网络 false为非计量网络
metered
:
Boolean
(
Number
.
parseInt
(
this
.
metered
)),
metered
:
Boolean
(
Number
.
parseInt
(
this
.
metered
)),
https
:
//gitee.com/openharmony/docs/pulls/14404
// 到达流量限制后的动作 详见[LimitAction](../reference/apis/js-apis-net-policy.md#limitaction)
limitAction
:
Number
.
parseInt
(
this
.
limitAction
)
};
...
...
zh-cn/application-dev/connectivity/net-sharing.md
浏览文件 @
410df270
...
...
@@ -4,7 +4,7 @@
网络共享管理分享设备已有网络给其他连接设备,支持Wi-Fi热点共享、蓝牙共享和USB共享,同时提供网络共享状态、共享流量查询功能。
> **说明:**
>
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本
。
>
为了保证应用的运行效率,大部分API调用都是异步的,对于异步调用的API均提供了callback和Promise两种方式,以下示例均采用callback函数,更多方式可以查阅[API参考](../reference/apis/js-apis-net-sharing.md)
。
## 基本概念
-
WIFI共享:通过WIFI热点共享网络。
...
...
@@ -14,6 +14,7 @@
## 约束
-
开发语言:C++ JS
-
系统:linux内核
-
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 场景介绍
网络共享的典型场景有:
...
...
@@ -23,30 +24,20 @@
以下分别介绍具体开发方式。
## 接口说明
完整的JS API说明以及实例代码请参考:
[
网络共享
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/apis/js-apis-net-sharing.md
)
。
完整的JS API说明以及实例代码请参考:
[
网络共享
](
..
/reference/apis/js-apis-net-sharing.md
)
。
| 类型 | 接口 | 功能说明 |
| ---- | ---- | ---- |
| ohos.net.sharing | function isSharingSupported(callback: AsyncCallback
\<
boolean>): void; | 获取当前系统是否支持网络共享,使用callback方式作为异步方法 |
| ohos.net.sharing | function isSharingSupported(): Promise
\<
boolean>; | 获取当前系统是否支持网络共享,使用Promise方式作为异步方法 |
| ohos.net.sharing | function isSharing(callback: AsyncCallback
\<
boolean>): void; | 获取当前共享状态,使用callback方式作为异步方法 |
| ohos.net.sharing | function isSharing(): Promise
\<
boolean>; | 获取当前共享状态,使用Promise方式作为异步方法 |
| ohos.net.sharing | function startSharing(type: SharingIfaceType, callback: AsyncCallback
\<
void>): void; | 开启共享,type为共享类型,目前支持Wifi热点、蓝牙、USB,使用callback方式作为异步方法 |
| ohos.net.sharing | function startSharing(type: SharingIfaceType): Promise
\<
void>; | 开启共享,type为共享类型,目前支持Wifi热点、蓝牙、USB,使用Promise方式作为异步方法 |
| ohos.net.sharing | function stopSharing(type: SharingIfaceType, callback: AsyncCallback
\<
void>): void; | 停止指定类型共享,type为共享类型,包括Wifi热点、蓝牙、USB,使用callback方式作为异步方法 |
| ohos.net.sharing | function stopSharing(type: SharingIfaceType): Promise
\<
void>; | 停止指定类型共享,type为共享类型,包括Wifi热点、蓝牙、USB,使用Promise方式作为异步方法 |
| ohos.net.sharing | function getStatsRxBytes(callback: AsyncCallback
\<
number>): void; | 获取共享接收数据量,单位KB,使用callback方式作为异步方法 |
| ohos.net.sharing | function getStatsRxBytes(): Promise
\<
number>; | 获取共享接收数据量,单位KB,使用Promise方式作为异步方法 |
| ohos.net.sharing | function getStatsTxBytes(callback: AsyncCallback
\<
number>): void; | 获取共享发送数据量,单位KB,使用callback方式作为异步方法 |
| ohos.net.sharing | function getStatsTxBytes(): Promise
\<
number>; | 获取共享发送数据量,单位KB,使用Promise方式作为异步方法 |
| ohos.net.sharing | function getStatsTotalBytes(callback: AsyncCallback
\<
number>): void; | 获取共享总数据流量,单位KB,使用callback方式作为异步方法 |
| ohos.net.sharing | function getStatsTotalBytes(): Promise
\<
number>; | 获取共享总数据流量,单位KB,使用Promise方式作为异步方法 |
| ohos.net.sharing | function getSharingIfaces(state: SharingIfaceState, callback: AsyncCallback
\<
Array
\<
string>>): void; | 获取指定状态的网卡名称,state为状态,包括正在共享、可共享、共享错误,使用callback方式作为异步方法 |
| ohos.net.sharing | function getSharingIfaces(state: SharingIfaceState): Promise
\<
Array
\<
string>>; | 获取指定状态的网卡名称,state为状态,包括正在共享、可共享、共享错误,使用Promise方式作为异步方法 |
| ohos.net.sharing | function getSharingState(type: SharingIfaceType, callback: AsyncCallback
\<
SharingIfaceState>): void; | 获取指定类型共享状态,type为类型,目前支持Wifi热点、蓝牙、USB,使用callback方式作为异步方法 |
| ohos.net.sharing | function getSharingState(type: SharingIfaceType): Promise
\<
SharingIfaceState>; | 获取指定类型共享状态,type为类型,目前支持Wifi热点、蓝牙、USB,使用Promise方式作为异步方法 |
| ohos.net.sharing | function getSharableRegexes(type: SharingIfaceType, callback: AsyncCallback
\<
Array
\<
string>>): void; | 获取与指定类型匹配的网卡正则表达式列表,type为类型,目前支持Wifi热点、蓝牙、USB,使用callback方式作为异步方法 |
| ohos.net.sharing | function getSharableRegexes(type: SharingIfaceType): Promise
\<
Array
\<
string>>; | 获取与指定类型匹配的网卡正则表达式列表,type为类型,目前支持Wifi热点、蓝牙、USB,使用Promise方式作为异步方法 |
| ohos.net.sharing | function on(type: 'sharingStateChange', callback: Callback
\<
boolean>): void; | 注册共享状态改变监听,返回网络共享的状态。 |
| ohos.net.sharing | function off(type: 'sharingStateChange', callback?: Callback
\<
boolean>): void; | 注销共享状态改变监听,返回网络共享的状态。 |
| ohos.net.sharing | unction on(type: 'interfaceSharingStateChange', callback: Callback
\<
{ type: SharingIfaceType, iface: string, state: SharingIfaceState }>): void; | 注册指定网卡共享状态改变监听 |
...
...
@@ -56,8 +47,6 @@
## 开启网络共享
### 开发步骤
1.
从@ohos.net.sharing中导入sharing命名空间。
2.
注册监听共享状态的改变。
3.
调用startSharing方法,来开启指定类型共享。
...
...
zh-cn/application-dev/connectivity/socket-connection.md
浏览文件 @
410df270
...
...
@@ -20,7 +20,7 @@ Socket连接主要是通过Socket进行数据传输,支持TCP/UDP/TLS协议。
## 接口说明
完整的JS API说明以及实例代码请参考:
[
Socket连接
](
https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev
/reference/apis/js-apis-socket.md
)
。
完整的JS API说明以及实例代码请参考:
[
Socket连接
](
..
/reference/apis/js-apis-socket.md
)
。
Socket连接主要由socket模块提供。具体接口说明如下表。
...
...
@@ -70,8 +70,6 @@ TLS Socket连接主要由tls_socket模块提供。具体接口说明如下表。
## 应用TCP/UDP协议进行通信
### 开发步骤
UDP与TCP流程大体类似,下面以TCP为例:
1.
import需要的socket模块。
...
...
zh-cn/application-dev/reference/apis/js-apis-net-connection.md
浏览文件 @
410df270
#
网络连接管理
#
@ohos.net.connection (网络连接管理)
网络连接管理提供管理网络一些基础能力,包括获取默认激活的数据网络、获取所有激活数据网络列表、开启关闭飞行模式、获取网络能力信息等功能。
>
![](public_sys-resources/icon-note.gif)
**说明:**
> **说明:**
> 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
...
...
@@ -112,7 +112,7 @@ connection.getDefaultNet().then(function (data) {
## connection.getGlobalHttpProxy<sup>10+</sup>
getGlobalHttpProxy(callback: AsyncCallback
\<
HttpProxy>): void
;
getGlobalHttpProxy(callback: AsyncCallback
\<
HttpProxy>): void
获取网络的全局代理配置信息,使用callback方式作为异步方法。
...
...
@@ -173,7 +173,7 @@ connection.getGlobalHttpProxy().then((data) => {
## connection.setGlobalHttpProxy<sup>10+</sup>
setGlobalHttpProxy(httpProxy: HttpProxy, callback: AsyncCallback
\<
void>): void
;
setGlobalHttpProxy(httpProxy: HttpProxy, callback: AsyncCallback
\<
void>): void
设置网络全局Http代理配置信息,使用callback方式作为异步方法。
...
...
@@ -265,7 +265,7 @@ connection.setGlobalHttpProxy(httpProxy).then((error, data) => {
## connection.getAppNet<sup>9+</sup>
getAppNet(callback: AsyncCallback
\<
NetHandle>): void
;
getAppNet(callback: AsyncCallback
\<
NetHandle>): void
获取App绑定的网络信息,使用callback方式作为异步方法。
...
...
@@ -326,7 +326,7 @@ connection.getAppNet().then((data) => {
## connection.SetAppNet<sup>9+</sup>
setAppNet(netHandle: NetHandle, callback: AsyncCallback
\<
void>): void
;
setAppNet(netHandle: NetHandle, callback: AsyncCallback
\<
void>): void
绑定App到指定网络,绑定后的App只能通过指定网络访问外网,使用callback方式作为异步方法。
...
...
@@ -1472,7 +1472,7 @@ netCon.unregister(function (error) {
### bindSocket<sup>9+</sup>
bindSocket(socketParam: TCPSocket
\|
UDPSocket, callback: AsyncCallback
\<
void>): void
;
bindSocket(socketParam: TCPSocket
\|
UDPSocket, callback: AsyncCallback
\<
void>): void
将TCPSocket或UDPSocket绑定到当前网络,使用callback方式作为异步方法。
...
...
zh-cn/application-dev/reference/apis/js-apis-net-ethernet.md
浏览文件 @
410df270
#
以太网连接
#
@ohos.net.ethernet (以太网连接管理)
以太网连接管理主要提供有线网络能力,提供设置有线网络的IP地址,子网掩码,网关,DNS等信息
>
![](public_sys-resources/icon-note.gif)
**说明:**
> **说明:**
> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
...
...
zh-cn/application-dev/reference/apis/js-apis-net-policy.md
浏览文件 @
410df270
#
网络策略管理
#
@ohos.net.policy (网络策略管理)
网络策略管理通过对用户使用数据流量进行控制管理,采用防火墙技术实现网络策略的管理。
...
...
@@ -92,7 +92,7 @@ policy.setBackgroundPolicy(Boolean(Number.parseInt(this.isBoolean))).then((error
## policy.isBackgroundAllowed
isBackgroundAllowed(callback: AsyncCallback
\<
boolean>): void
;
isBackgroundAllowed(callback: AsyncCallback
\<
boolean>): void
获取后台网络策略,使用callback方式作为异步方法。
...
...
@@ -138,7 +138,7 @@ isBackgroundAllowed(): Promise\<boolean>;
| 类型 | 说明 |
| --------------------------------- | ------------------------------------- |
| Promise
\<
boolean> | 以Promise形式返回设定结果。
失败返回错误码错误信息。
|
| Promise
\<
boolean> | 以Promise形式返回设定结果。
返回true代表后台策略为允许。失败返回错误码错误信息。
|
**错误码:**
...
...
@@ -160,7 +160,7 @@ policy.isBackgroundAllowed().then((error, data) {
## policy.setPolicyByUid
setPolicyByUid(uid: number, policy: NetUidPolicy, callback: AsyncCallback
\<
void>): void
;
setPolicyByUid(uid: number, policy: NetUidPolicy, callback: AsyncCallback
\<
void>): void
设置对应uid应用的访问计量网络的策略,使用callback方式作为异步方法。
...
...
@@ -245,7 +245,7 @@ policy.setPolicyByUid(Number.parseInt(this.firstParam), Number.parseInt(this.cur
## policy.getPolicyByUid
getPolicyByUid(uid: number, callback: AsyncCallback
\<
NetUidPolicy>): void
;
getPolicyByUid(uid: number, callback: AsyncCallback
\<
NetUidPolicy>): void
通过应用uid获取策略,使用callback方式作为异步方法。
...
...
@@ -322,7 +322,7 @@ policy.getPolicyByUid(Number.parseInt(this.firstParam)).then((error, data) {
## policy.getUidsByPolicy
getUidsByPolicy(policy: NetUidPolicy, callback: AsyncCallback
\<
Array
\<
number>>): void
;
getUidsByPolicy(policy: NetUidPolicy, callback: AsyncCallback
\<
Array
\<
number>>): void
通过策略获取设置这一策略的应用uid数组,使用callback方式作为异步方法。
...
...
@@ -399,7 +399,7 @@ policy.getUidsByPolicy(Number.parseInt(this.firstParam)).then((error, data) {
## policy.getNetQuotaPolicies
getNetQuotaPolicies(callback: AsyncCallback
\<
Array
\<
NetQuotaPolicy>>): void
;
getNetQuotaPolicies(callback: AsyncCallback
\<
Array
\<
NetQuotaPolicy>>): void
获取计量网络策略,使用callback方式作为异步方法。
...
...
@@ -465,7 +465,7 @@ policy.getNetQuotaPolicies().then((error, data) {
## policy.setNetQuotaPolicies
setNetQuotaPolicies(quotaPolicies: Array
\<
NetQuotaPolicy>, callback: AsyncCallback
\<
void>): void
;
setNetQuotaPolicies(quotaPolicies: Array
\<
NetQuotaPolicy>, callback: AsyncCallback
\<
void>): void
设置计量网络策略,使用callback方式作为异步方法。
...
...
@@ -549,7 +549,7 @@ policy.setNetQuotaPolicies(this.netQuotaPolicyList).then((error, data) {
## policy.restoreAllPolicies
restoreAllPolicies(iccid: string, callback: AsyncCallback
\<
void>): void
;
restoreAllPolicies(iccid: string, callback: AsyncCallback
\<
void>): void
重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略,使用callback方式作为异步方法。
...
...
@@ -628,7 +628,7 @@ policy.restoreAllPolicies(this.firstParam).then((error, data){
## policy.isUidNetAllowed
isUidNetAllowed(uid: number, isMetered: boolean, callback: AsyncCallback
\<
boolean>): void
;
isUidNetAllowed(uid: number, isMetered: boolean, callback: AsyncCallback
\<
boolean>): void
获取对应uid能否访问计量或非计量网络,使用callback方式作为异步方法。
...
...
@@ -715,7 +715,7 @@ policy.isUidNetAllowed(Number.parseInt(this.firstParam), Boolean(Number.parseInt
## policy.isUidNetAllowed
isUidNetAllowed(uid: number, iface: string, callback: AsyncCallback
\<
boolean>): void
;
isUidNetAllowed(uid: number, iface: string, callback: AsyncCallback
\<
boolean>): void
获取对应uid能否访问指定的iface的网络,使用callback方式作为异步方法。
...
...
@@ -801,7 +801,7 @@ policy.isUidNetAllowed(Number.parseInt(this.firstParam), this.secondParam).then(
## policy.setDeviceIdleAllowList
setDeviceIdleAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback
\<
void>): void
;
setDeviceIdleAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback
\<
void>): void
设置指定uid应用是否在休眠防火墙的白名单,使用callback方式作为异步方法。
...
...
@@ -886,7 +886,7 @@ policy.setDeviceIdleAllowList(Number.parseInt(this.firstParam), Boolean(Number.p
## policy.getDeviceIdleAllowList
getDeviceIdleAllowList(callback: AsyncCallback
\<
Array
\<
number>>): void
;
getDeviceIdleAllowList(callback: AsyncCallback
\<
Array
\<
number>>): void
获取休眠模式白名单所包含的uid数组,使用callback方式作为异步方法。
...
...
@@ -951,7 +951,7 @@ policy.getDeviceIdleAllowList().then((error, data) {
## policy.getBackgroundPolicyByUid
getBackgroundPolicyByUid(uid: number, callback: AsyncCallback
\<
NetBackgroundPolicy>): void
;
getBackgroundPolicyByUid(uid: number, callback: AsyncCallback
\<
NetBackgroundPolicy>): void
获取指定uid能否访问后台网络,使用callback方式作为异步方法。
...
...
@@ -1029,7 +1029,7 @@ policy.getBackgroundPolicyByUid(Number.parseInt(this.firstParam)).then((error, d
## policy.resetPolicies
resetPolicies(iccid: string, callback: AsyncCallback
\<
void>): void
;
resetPolicies(iccid: string, callback: AsyncCallback
\<
void>): void
重置对应sim卡id的蜂窝网络、后台网络策略、防火墙策略、应用对应的策略,使用callback方式作为异步方法。
...
...
@@ -1111,7 +1111,7 @@ policy.resetPolicies(this.firstParam).then((error, data) {
## policy.updateRemindPolicy
updateRemindPolicy(netType: NetBearType, iccid: string, remindType: RemindType, callback: AsyncCallback
\<
void>): void
;
updateRemindPolicy(netType: NetBearType, iccid: string, remindType: RemindType, callback: AsyncCallback
\<
void>): void
更新提醒策略,使用callback方式作为异步方法。
...
...
@@ -1198,7 +1198,7 @@ policy.updateRemindPolicy(Number.parseInt(this.netType), this.firstParam, Number
## policy.setPowerSaveAllowList
setPowerSaveAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback
\<
void>): void
;
setPowerSaveAllowList(uid: number, isAllowed: boolean, callback: AsyncCallback
\<
void>): void
设置指定uid应用是否在省电防火墙的白名单,使用callback方式作为异步方法。
...
...
@@ -1283,7 +1283,7 @@ policy.setPowerSaveAllowList(Number.parseInt(this.firstParam), Boolean(Number.pa
## policy.getPowerSaveAllowList
getPowerSaveAllowList(callback: AsyncCallback
\<
Array
\<
number>>): void
;
getPowerSaveAllowList(callback: AsyncCallback
\<
Array
\<
number>>): void
获取省电模式白名单所包含的uid数组,使用callback方式作为异步方法。
...
...
@@ -1352,7 +1352,7 @@ policy.getPowerSaveAllowList().then((error, data) {
### on('netUidPolicyChange')
on(type: "netUidPolicyChange", callback: Callback
\<
{ uid: number, policy: NetUidPolicy }>): void
;
on(type: "netUidPolicyChange", callback: Callback
\<
{ uid: number, policy: NetUidPolicy }>): void
注册policy发生改变时的回调,使用callback方式作为异步方法。
...
...
@@ -1377,7 +1377,7 @@ policy.on('netUidPolicyChange', (data) => {
### on('netUidRuleChange')
on(type: "netUidRuleChange", callback: Callback
\<
{ uid: number, rule: NetUidRule }>): void
;
on(type: "netUidRuleChange", callback: Callback
\<
{ uid: number, rule: NetUidRule }>): void
注册rule发生改变时的回调,使用callback方式作为异步方法。
...
...
@@ -1402,7 +1402,7 @@ policy.on('netUidRuleChange', (data) => {
### on('netMeteredIfacesChange')
on(type: "netMeteredIfacesChange", callback: Callback
\<
Array
\<
string>>): void
;
on(type: "netMeteredIfacesChange", callback: Callback
\<
Array
\<
string>>): void
注册计量iface发生改变时的回调,使用callback方式作为异步方法。
...
...
@@ -1427,7 +1427,7 @@ policy.on('netMeteredIfacesChange', (data) => {
### on('netQuotaPolicyChange')
on(type: "netQuotaPolicyChange", callback: Callback
\<
Array
\<
NetQuotaPolicy>>): void
;
on(type: "netQuotaPolicyChange", callback: Callback
\<
Array
\<
NetQuotaPolicy>>): void
注册计量网络策略发生改变时的回调,使用callback方式作为异步方法。
...
...
@@ -1452,7 +1452,7 @@ policy.on('netQuotaPolicyChange', (data) => {
### on('netBackgroundPolicyChange')
on(type: "netBackgroundPolicyChange", callback: Callback
\<
boolean>): void
;
on(type: "netBackgroundPolicyChange", callback: Callback
\<
boolean>): void
注册后台网络策略发生改变时的回调,使用callback方式作为异步方法。
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录