HarmonyOSNEXT 网络连接管理全攻略

// 网络三要素定义type NetProducer = 'WiFi' | '蜂窝网络' | '以太网'; // 网络提供者type NetConsumer = App | 系统服务;        // 网络使用者type NetMonitor = '连接探测' | 'DNS检测' | 'HTTPS验证'; // 网络健康检查员

// 异步调用规范示例connection.getDefaultNet().then((netHandle) => {  console.log("当前默认网络ID：" + netHandle.netId);}).catch((error) => {  console.error("获取失败：" + error.code);});

// 网络状态监听实战import { connection } from '@kit.NetworkKit';
const netConnection = connection.createNetConnection();netConnection.on('netAvailable', (netHandle) => {  console.log(`🎉 网络切换成功！新网络ID：${netHandle.netId}`);});netConnection.register(); // 开启监听

// 网络状态变化监听模板const specifier = {  netCapabilities: {    bearerTypes: [connection.NetBearType.BEARER_CELLULAR],    networkCap: [connection.NetCap.NET_CAPABILITY_INTERNET]  }};
const conn = connection.createNetConnection(specifier);conn.on('netAvailable', handleNetworkChange); // 网络可用时触发conn.on('netLost', handleNetworkLoss);        // 网络丢失时触发

// 网络切换自动重连示例let currentSession: rcp.Session;
function createNewSession() {  currentSession?.close();  currentSession = rcp.createSession();  // 这里添加你的网络请求逻辑}
connection.createNetConnection().on('netAvailable', createNewSession);

// 判断网络类型代码片段connection.getNetCapabilities(netHandle).then((caps) => {  if (caps.bearerTypes.includes(0)) {    console.log("📶 当前是蜂窝网络");  } else if (caps.bearerTypes.includes(1)) {    console.log("🛜 当前是WiFi网络");  }});

// 智能DNS解析示例connection.getAddressesByName("www.example.com").then((addresses) => {  console.log("🌍 解析到IP地址：" + addresses.join(', '));});

// 强制报告网络状态connection.reportNetDisconnected(badNetHandle); // 标记问题网络connection.reportNetConnected(goodNetHandle);   // 确认可用网络