鸿蒙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>): void

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

3）unregister(callback: AsyncCallback<void>): void

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

4）on(type: 'netAvailable', callback: Callback<NetHandle>): 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<NetHandle>): void

订阅网络丢失事件。

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

订阅网络不可用事件。

3. 网络状态监测示例

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

下面详细介绍创建该应用的步骤。

步骤1：创建Empty Ability项目。

步骤2：在module.json5配置文件加上对权限的声明：

"requestPermissions": [
      {
        "name": "ohos.permission.GET_NETWORK_INFO"
      }
    ]

这里添加了获取WIFI信息的权限。

步骤3：在Index.ets文件里添加如下的代码：

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

@Entry
@Component
struct Index {
  //连接、通讯历史记录
  @State msgHistory: string = ''
  @State listening: boolean = false
  currentNet: connection.NetConnection
  scroller: Scroller = new Scroller()

  build() {
    Row() {
      Column() {
        Text("网络状态监测")
          .fontSize(14)
          .fontWeight(FontWeight.Bold)
          .width('100%')
          .textAlign(TextAlign.Center)
          .padding(10)

        Flex({ justifyContent: FlexAlign.End, alignItems: ItemAlign.Center }) {

          Button(this.listening ? "停止监测" : "开始监测")
            .width(120)
            .fontSize(14)
            .flexGrow(0)
            .onClick(() => {
              this.listenButClick()
            })
        }
        .width('100%')
        .padding(10)

        Scroll(this.scroller) {
          Text(this.msgHistory)
            .textAlign(TextAlign.Start)
            .padding(10)
            .width('100%')
            .backgroundColor(0xeeeeee)
        }
        .align(Alignment.Top)
        .backgroundColor(0xeeeeee)
        .height(300)
        .flexGrow(1)
        .scrollable(ScrollDirection.Vertical)
        .scrollBar(BarState.On)
        .scrollBarWidth(20)
      }
      .width('100%')
      .justifyContent(FlexAlign.Start)
      .height('100%')
    }
    .height('100%')
  }

  //监听按钮点击
  listenButClick() {
    this.listening = !this.listening
    if (this.listening) {

      this.currentNet = connection.createNetConnection()
      this.currentNet.register((error) => {
        if (error) {
          this.msgHistory += "订阅失败" + JSON.stringify(error) + "\r\n"
        } else {
          this.msgHistory += "订阅成功\r\n"
        }
      })

      this.currentNet.on("netAvailable", (data) => {
        this.msgHistory += "网络有效\r\n"
      })

      this.currentNet.on("netCapabilitiesChange", (data) => {
        let netType = ""
        if (data.netCap.bearerTypes[0].valueOf() == 0) {
          netType = "蜂窝网络"
        } else if (data.netCap.bearerTypes[0].valueOf() == 1) {
          netType = "Wi-Fi网络"
        }
        else if (data.netCap.bearerTypes[0].valueOf() == 3) {
          netType = "以太网网络"
        }

        this.msgHistory += `网络类型:${netType}\r\n`
        this.msgHistory += `网络能力（kbps）:${data.netCap.linkUpBandwidthKbps}/${data.netCap.linkDownBandwidthKbps}\r\n`
      })

      this.currentNet.on("netConnectionPropertiesChange", (data) => {
        this.msgHistory += `网卡名称:${data.connectionProperties.interfaceName}\r\n`
        for (let i = 0; i < data.connectionProperties.dnses.length; i++) {
          this.msgHistory += `DNS${i}:${data.connectionProperties.dnses[i].address}\r\n`
        }

        for (let i = 0; i < data.connectionProperties.linkAddresses.length; i++) {
          this.msgHistory += `IP${i}:${data.connectionProperties.linkAddresses[i].address.address}\r\n`
        }

        this.msgHistory += `mtu:${data.connectionProperties.mtu}\r\n`
      })

      this.currentNet.on("netLost", (data) => {
        this.msgHistory += `网络丢失\r\n`
      })

      this.currentNet.on("netUnavailable", (data) => {
        this.msgHistory += `网络不可用\r\n`
      })
    }
    else {
      this.currentNet.unregister(() => {
      })
    }
  }
}

步骤4：编译运行，可以使用模拟器或者真机。

步骤5：单击“开始监测”按钮，然后可以通过断开和链接WLAN模拟网络状态变化，截图如下所示：

这样就完成了一个简单的网络状态监测应用。

最后

小编在之前的鸿蒙系统扫盲中，有很多朋友给我留言，不同的角度的问了一些问题，我明显感觉到一点，那就是许多人参与鸿蒙开发，但是又不知道从哪里下手，因为资料太多，太杂，教授的人也多，无从选择。有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

为了确保高效学习，建议规划清晰的学习路线，涵盖以下关键阶段：

 →【纯血版鸿蒙全套最新学习资料】希望这一份鸿蒙学习资料能够给大家带来帮助~

---

 鸿蒙（HarmonyOS NEXT）最新学习路线

​

该路线图包含基础技能、就业必备技能、多媒体技术、六大电商APP、进阶高级技能、实战就业级设备开发，不仅补充了华为官网未涉及的解决方案

路线图适合人群：

IT开发人员：想要拓展职业边界
零基础小白：鸿蒙爱好者，希望从0到1学习，增加一项技能。
技术提升/进阶跳槽：发展瓶颈期，提升职场竞争力，快速掌握鸿蒙技术

2.视频学习资料+学习PDF文档

HarmonyOS Next 最新全套视频教程 （鸿蒙语法ArkTS、TypeScript、ArkUI教程……）

​​

 纯血版鸿蒙全套学习资料（面试、文档、全套视频等）

                   

​​​​鸿蒙APP开发必备

​​

总结

【纯血版鸿蒙全套最新学习资料】

总的来说，华为鸿蒙不再兼容安卓，对程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，才能在这个变革的时代中立于不败之地。