鸿蒙HarmonyOS NEXT开发实战：网络连接管理

鸿蒙开发往期必看：

HarmonyOS NEXT应用开发性能实践总结

一分钟了解”纯血版！鸿蒙HarmonyOS Next应用开发！

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

 “一杯冰美式的时间” 了解鸿蒙HarmonyOS Next应用开发路径！

---

简介

网络连接管理提供管理网络一些基础能力，包括WiFi/蜂窝/Ethernet等多网络连接优先级管理、网络质量评估、订阅默认/指定网络连接状态变化、查询网络连接信息、DNS解析等功能。

说明

为了保证应用的运行效率，大部分API调用都是异步的，对于异步调用的API均提供了callback和Promise两种方式，以下示例均采用promise函数，更多方式可以查阅API参考。

基本概念

• 网络生产者：数据网络的提供方，比如WiFi、蜂窝、Ethernet等。
• 网络消费者：数据网络的使用方，比如应用或系统服务。
• 网络探测：检测网络有效性，避免将网络从可用网络切换到不可用网络。内容包括绑定网络探测、DNS探测、HTTP探测及HTTPS探测。
• 网络优选：处理多网络共存时选择最优网络。在网络状态、网络信息及评分发生变化时被触发。

约束

• 开发语言：JS
• 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

场景介绍

网络连接管理的典型场景有：

• 接收指定网络的状态变化通知
• 获取所有注册的网络
• 根据数据网络查询网络的连接信息
• 使用对应网络解析域名，获取所有IP

以下分别介绍具体开发方式。

接口说明

完整的JS API说明以及实例代码请参考：网络连接管理。

接口名	描述
getDefaultNet(callback: AsyncCallback<NetHandle>): void;	获取一个含有默认网络的netId的NetHandle对象，使用callback回调
getGlobalHttpProxy(callback: AsyncCallback<HttpProxy>): void;	获取网络的全局代理设置，使用callback回调