在復雜的物聯(lián)網(wǎng)應用場景中，設備往往需要支持以太網(wǎng)、Wi-Fi及4G等多種網(wǎng)絡接入方式。exnetif模塊作為實現(xiàn)多網(wǎng)融合的核心組件，通過抽象化的接口屏蔽了底層硬件的差異。本文將深入解析如何利用exnetif.setproxy等API，配置網(wǎng)絡代理與智能選路策略，實現(xiàn)4G與有線網(wǎng)絡之間的無縫切換與數(shù)據(jù)透傳，讓您的設備具備極高的網(wǎng)絡適應性與可靠性。

專為多網(wǎng)絡環(huán)境設計，用簡潔的API幫你輕松搞定網(wǎng)絡優(yōu)先級管理和多網(wǎng)融合，無論是智能網(wǎng)關、工業(yè)路由器，還是其他需要多網(wǎng)備份與共享的物聯(lián)網(wǎng)設備，都能從中受益。

一、exnetif是什么？

exnetif是一個用于簡化多網(wǎng)絡環(huán)境管理的LuatOS擴展庫。主要提供兩大核心能力：

網(wǎng)絡優(yōu)先級管理：可靈活設置以太網(wǎng)、Wi-Fi、4G等網(wǎng)絡的優(yōu)先級（例如：以太網(wǎng) > Wi-Fi > 4G），模塊會自動選擇當前優(yōu)先級最高且連通性最好的網(wǎng)卡上網(wǎng)，實現(xiàn)智能切換。

多網(wǎng)融合功能：支持配置網(wǎng)絡代理，實現(xiàn)網(wǎng)絡共享（例如將4G作為數(shù)據(jù)出口，供Wi-Fi/以太網(wǎng)設備接入）；模塊最多同時掛載5個以太網(wǎng)網(wǎng)口，支持LAN、WAN隨意組合使用。

二、核心函數(shù)速覽

exnetif擴展庫目前提供了四個主要API，覆蓋了從網(wǎng)絡初始化、狀態(tài)回調到多網(wǎng)融合的全流程。

2.1、exnetif.set_priority_order(networkConfigs)

函數(shù)功能：設置網(wǎng)絡優(yōu)先級并初始化網(wǎng)絡。

注意事項：

可以開啟單網(wǎng)絡或多網(wǎng)優(yōu)先級，單網(wǎng)時不會判斷網(wǎng)絡連通性，多網(wǎng)絡時根據(jù)table中的順序確定聯(lián)網(wǎng)優(yōu)先級。

簡要示例：

2.2、exnetif.notify_status(cb_fnc)

函數(shù)功能：設置網(wǎng)絡狀態(tài)變化回調函數(shù)。

注意事項：

可選配置，設置回調函數(shù)后可以通過回調函數(shù)獲取網(wǎng)絡狀態(tài)的變化。

簡要示例：

2.3、exnetif.setproxy(adapter, main_adapter, other_configs)

函數(shù)功能：配置網(wǎng)絡代理實現(xiàn)多網(wǎng)融合。

注意事項：

注意區(qū)分adapter和main_adapter的參數(shù)：

adapter：使用網(wǎng)絡的網(wǎng)卡（如socket.LWIP_AP）；

main_adapter：提供網(wǎng)絡的網(wǎng)卡（如socket.LWIP_ETH）。

簡要示例：

2.4、exnetif.check_network_status(interval)

函數(shù)功能：主動觸發(fā)網(wǎng)絡狀態(tài)檢測。

注意事項：

可選配置，檢測一次或者定時檢測所有可用網(wǎng)絡的網(wǎng)絡連通性，當網(wǎng)絡顯示可用但是業(yè)務代碼數(shù)據(jù)收發(fā)異常時可以重新檢測網(wǎng)絡連通性，如果配置定時檢測會增加模塊功耗。

簡要示例：

三、快速上手：多網(wǎng)融合示例

目前exnetif庫已全面支持LuatOS開發(fā)系列主流產品，同時提供相關應用示例demo，方便開發(fā)者快速上手，可結合項目實際需求靈活運用。

注意：

多網(wǎng)融合功能需硬件支持，如雙網(wǎng)卡設備；

以Air8000系列多功能工業(yè)引擎/開發(fā)板為例：

核心示例代碼如下圖示，完整demo詳見源碼倉庫最新文件：

3.1 4G連接外部網(wǎng)絡

開啟多網(wǎng)融合模式，4G連接外部網(wǎng)絡，生成Wi-Fi熱點為Wi-Fi終端設備提供接入，支持以太網(wǎng)Lan模式為其他以太網(wǎng)設備提供接入；網(wǎng)絡監(jiān)控，每5秒進行HTTPS連接測試，實時監(jiān)測4G網(wǎng)絡的連接狀態(tài)。

3.2 以太網(wǎng)連接外部網(wǎng)絡

開啟多網(wǎng)融合模式，以太網(wǎng)連接外部網(wǎng)絡，生成Wi-Fi熱點為WiFi終端設備提供接入，支持以太網(wǎng)Lan模式為其他以太網(wǎng)設備提供接入；網(wǎng)絡監(jiān)控，每5秒進行HTTPS連接測試，實時監(jiān)測以太網(wǎng)網(wǎng)絡的連接狀態(tài)。

3.3 Wi-Fi連接外部網(wǎng)絡

開啟多網(wǎng)融合模式，Wi-Fi連接外部網(wǎng)絡，支持以太網(wǎng)Lan模式為其他以太網(wǎng)設備提供接入，支持生成Wi-Fi熱點為Wi-Fi終端設備提供接入；網(wǎng)絡監(jiān)控，每5秒進行HTTPS連接測試，實時監(jiān)測Wi-Fi網(wǎng)絡的連接狀態(tài)。

今天的內容就分享到這里了~