鸿蒙网络编程系列19-获取网络连接信息并选择一种绑定到应用示例

1. 网络类型简介

移动设备一般都具备移动网络和无线WIFI的连接能力,有些还可以接入有线以太网,这些网络可以根据需要随时切换。鸿蒙APP可以自动适应上述的网络,一般来说,会优先使用WIFI或者有线以太网,移动网络因为要收费,不会首选使用。但是在某些特殊情形下,可能要求必须使用某一种网络,比如必须使用蜂窝网络,这时候就需要显示的配置一下,指定app使用该网络类型。

2. Web组件及控制器常用方法

网络连接相关能力位于connection模块下,使用如下的方式导入:

复制代码
import connection from '@ohos.net.connection'

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

1)getAllNets(): Promise<Array<NetHandle>>

获取所有处于连接状态的网络列表,使用Promise方式作为异步方法。

2)getConnectionProperties(netHandle: NetHandle): Promise<ConnectionProperties>

获取netHandle对应的网络的连接信息,使用Promise方式作为异步方法。

3)getNetCapabilities(netHandle: NetHandle): Promise<NetCapabilities>

获取netHandle对应的网络的能力信息,使用Promise方式作为异步方法。

4)setAppNet(netHandle: NetHandle): Promise<void>;

绑定App到指定网络,绑定后的App只能通过指定网络访问外网,使用Promise方式作为异步方法。

3. 获取网络连接信息并选择一种绑定到应用

本示例会列出所有激活中的网络,然后可以选择其中一种绑定到当前APP,最后可以通过访问指定的网页验证是否绑定成功,示例运行后的初始界面如下所示:

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

步骤1:创建Empty Ability项目。

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

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

这里添加了获取WIFI信息以及访问互联网的权限。

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

import connection from '@ohos.net.connection';
import web_webview from '@ohos.web.webview'
​
@Entry
@Component
struct Index {
  //连接、通讯历史记录
  @State msgHistory: string = ''
  scroller: Scroller = new Scroller()
  //网络类型列表
  @State netShowArray: Array<SelectOption> = new Array<SelectOption>()
  //网络句柄数组
  netHandleArray: Array<connection.NetHandle> = new Array<connection.NetHandle>()
  //选中的网络序号
  selectNetIndx: number = 0
  //要测试的网址
  @State webUrl: string = "http://192.168.100.100:8080/index"
  //显示网页的控制器
  controller: web_webview.WebviewController = new web_webview.WebviewController()
​
  build() {
    Row() {
      Column() {
        Text("绑定应用使用的网络")
          .fontSize(14)
          .fontWeight(FontWeight.Bold)
          .width('100%')
          .textAlign(TextAlign.Center)
          .padding(10)
​
        Flex({ justifyContent: FlexAlign.SpaceBetween, alignItems: ItemAlign.Center }) {
          Button("查看网络信息")
            .width(120)
            .fontSize(14)
            .flexGrow(0)
            .onClick(() => {
              this.ShowNetInfo()
            })
​
          Select(this.netShowArray)
            .width(100)
            .value("选择网络")
            .flexGrow(1)
            .onSelect((index, value) => {
              this.selectNetIndx = index
            })
​
          Button("绑定")
            .width(120)
            .fontSize(14)
            .flexGrow(0)
            .onClick(() => {
              connection.setAppNet(this.netHandleArray[this.selectNetIndx])
                .then(() => {
                  this.msgHistory += "绑定成功\r\n"
                })
                .catch((error) => {
                  this.msgHistory += "绑定出错" + error.message + "\r\n"
                })
            })
        }
        .width('100%')
        .padding(10)
​
        Scroll(this.scroller) {
          Text(this.msgHistory)
            .textAlign(TextAlign.Start)
            .fontSize(10)
            .padding(10)
            .width('100%')
            .backgroundColor(0xeeeeee)
        }
        .align(Alignment.Top)
        .backgroundColor(0xeeeeee)
        .height(200)
        .flexGrow(1)
        .scrollable(ScrollDirection.Vertical)
        .scrollBar(BarState.On)
        .scrollBarWidth(20)
​
        Flex({ justifyContent: FlexAlign.Start, alignItems: ItemAlign.Center }) {
          Text("网址:")
            .fontSize(14)
            .width(50)
            .flexGrow(0)
​
          TextInput({ text: this.webUrl })
            .onChange((value) => {
              this.webUrl = value
            })
            .width(110)
            .fontSize(11)
            .flexGrow(1)
​
          Button("加载")
            .onClick(() => {
              this.controller.loadUrl(this.webUrl);
            })
            .width(60)
            .fontSize(14)
            .flexGrow(0)
        }
        .width('100%')
        .padding(5)
​
        Web({ src: this.webUrl, controller: this.controller })
          .padding(10)
          .width('100%')
          .backgroundColor(0xeeeeee)
          .height(200)
          .flexGrow(1)
      }
      .width('100%')
      .justifyContent(FlexAlign.Start)
      .height('100%')
    }
    .height('100%')
  }
​
  showConnectionPropInfo(connProp: connection.ConnectionProperties) {
    this.msgHistory += `网卡名称:${connProp.interfaceName}\r\n`
    for (let i = 0; i < connProp.dnses.length; i++) {
      this.msgHistory += `DNS${i}:${connProp.dnses[i].address}\r\n`
    }
​
    for (let i = 0; i < connProp.linkAddresses.length; i++) {
      this.msgHistory += `IP${i}:${connProp.linkAddresses[i].address.address}\r\n`
    }
​
    this.msgHistory += `mtu:${connProp.mtu}\r\n`
  }
​
  showNetCapInfo(connCap: connection.NetCapabilities) {
​
    let netType = ""
    if (connCap.bearerTypes[0].valueOf() == 0) {
      netType = "蜂窝网络"
    } else if (connCap.bearerTypes[0].valueOf() == 1) {
      netType = "Wi-Fi网络"
    }
    else if (connCap.bearerTypes[0].valueOf() == 3) {
      netType = "以太网网络"
    }
    //添加网络类型到下拉列表
    this.netShowArray.push({ value: netType })
    this.msgHistory += `网络类型:${netType}\r\n`
    this.msgHistory += `网络能力(kbps):${connCap.linkUpBandwidthKbps}/${connCap.linkDownBandwidthKbps}\r\n`
  }
​
  //显示网络信息
  async ShowNetInfo() {
    this.netHandleArray = await connection.getAllNets();
    this.msgHistory += `激活网络数量:${this.netHandleArray.length}\r\n\r\n`
​
    //清空下拉列表元素
    this.netShowArray.splice(0, this.netShowArray.length);
​
    for (let i = 0; i < this.netHandleArray.length; i++) {
      let connProp = await connection.getConnectionProperties(this.netHandleArray[i])
      this.showConnectionPropInfo(connProp)
​
      let connCap = await connection.getNetCapabilities(this.netHandleArray[i])
      this.showNetCapInfo(connCap)
      this.msgHistory += "\r\n"
    }
  }
}

步骤4:编译运行,最好使用真机。

步骤5:单击"查看网络信息"按钮,列出当前网络信息,截图如下所示:

步骤6:在"选择网络"选择网络类型,比如"蜂窝网络",然后单击"绑定"按钮,如图所示:

这样就就绑定到了指定的网络。

步骤7:输入特定的网址,然后单击"加载"按钮既可测试当前绑定的网络。

3. 注意事项

笔者手机默认情况下只有一个激活的网络,可以在开发人员选项下选择"始终开启移动数据",这样就可以列出多个网络,如图所示:

(本文作者原创,除非明确授权禁止转载)

本文源码地址:

https://gitee.com/zl3624/harmonyos_network_samples/tree/master/code/others/SpecifyAppNetworkType

本系列源码地址:

https://gitee.com/zl3624/harmonyos_network_samples

相关推荐
Mr.Pascal39 分钟前
刚学php序列化/反序列化遇到的坑(攻防世界:Web_php_unserialize)
开发语言·安全·web安全·php
虚拟网络工程师1 小时前
【网络系统管理】Centos7——配置主从mariadb服务器案例(下半部分)
运维·服务器·网络·数据库·mariadb
建群新人小猿1 小时前
会员等级经验问题
android·开发语言·前端·javascript·php
JosieBook2 小时前
【网络工程】查看自己电脑网络IP,检查网络是否连通
服务器·网络·tcp/ip
SuperHeroWu72 小时前
【HarmonyOS】鸿蒙应用接入微博分享
华为·harmonyos·鸿蒙·微博·微博分享·微博sdk集成·sdk集成
黑客Ash3 小时前
计算机中的网络安全
网络·安全·web安全
PersistJiao3 小时前
Spark 分布式计算中网络传输和序列化的关系(二)
大数据·网络·spark·序列化·分布式计算
岳不谢4 小时前
VPN技术-VPN简介学习笔记
网络·笔记·学习·华为
follycat4 小时前
信息收集--CDN绕过
网络·安全·网络安全
zhangjr05754 小时前
【HarmonyOS Next】鸿蒙实用装饰器一览(一)
前端·harmonyos·arkts