鸿蒙HarmonyOS应用开发之网络状态监测常用方法示例-connection指导

1. 网络状态简介

移动设备一般都具备移动网络和无线WIFI的连接能力，有些还可以接入有线以太网，这些网络可以根据需要随时切换，在网络切换过程中，伴随着网络状态的变化，比如网卡名称、IP地址、上传下载能力等等，鸿蒙提供了网络状态变化的监测api，可以随时根据需要捕获状态的改变。

2. 网络状态监测常用方法

鸿蒙封装的connection模块提供了状态监测能力，使用如下的方式导入：

import connection from '@ohos.net.connection'

connection模块包括了众多的操作方法，就本文而言，重点需要掌握的是如下八个：

1）createNetConnection(netSpecifier?: NetSpecifier, timeout?: number): NetConnection

返回一个NetConnection对象，参数netSpecifier指定关注的网络的各项特征，timeout是超时时间(单位是毫秒)，netSpecifier是timeout的必要条件，两者都没有则表示关注默认网络。

2）register(callback: AsyncCallback): void

订阅指定网络状态变化的通知，只有订阅后才能得到后续的回调。

3）unregister(callback: AsyncCallback): void

取消订阅默认网络状态变化的通知。

4）on(type: 'netAvailable', callback: Callback): void

订阅网络可用事件。

5）on(type: 'netCapabilitiesChange', callback: Callback<{ netHandle: NetHandle, netCap: NetCapabilities }>): void

订阅网络能力变化事件。

6）on(type: 'netConnectionPropertiesChange', callback: Callback<{ netHandle: NetHandle, connectionProperties: ConnectionProperties }>): void

订阅网络连接信息变化事件。

7）on(type: 'netLost', callback: Callback): void

订阅网络丢失事件。

8）on(type: 'netUnavailable', callback: Callback): void

订阅网络不可用事件。

3. 网络状态监测示例

本示例会获取当前设备的网络状态变化，运行后的初始界面如下所示：