專為多網(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)回調(diào)到多網(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)變化回調(diào)函數(shù)。
注意事項：
可選配置，設置回調(diào)函數(shù)后可以通過回調(diào)函數(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ā)系列主流產(chǎn)品，同時提供相關應用示例demo，方便開發(fā)者快速上手，可結(jié)合項目實際需求靈活運用。
注意：
多網(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)。
今天的內(nèi)容就分享到這里了~
