MAUI怎么監(jiān)聽網(wǎng)絡(luò)狀態(tài)變化 MAUI Connectivity教程
MAUI 監(jiān)聽網(wǎng)絡(luò)狀態(tài)變化核心依賴 Microsoft.Maui.Essentials.Connectivity,它跨平臺、免權(quán)限、無需原生代碼;通過 NetworkAccess 判斷互聯(lián)網(wǎng)可達性(Internet/Local/None),用 ConnectivityChanged 事件實時響應(yīng)變化,并支持 ConnectionProfiles 區(qū)分 WiFi/蜂窩等類型。

MAUI 監(jiān)聽網(wǎng)絡(luò)狀態(tài)變化,核心靠 Microsoft.Maui.Essentials.Connectivity,它跨平臺、開箱即用,不需要額外權(quán)限(iOS/Android 側(cè)系統(tǒng)已默認支持),也不用寫原生橋接代碼。
獲取當(dāng)前網(wǎng)絡(luò)訪問狀態(tài)
Connectivity 提供的是“是否能訪問互聯(lián)網(wǎng)”的語義判斷,不是單純看有沒有連上 WiFi 或蜂窩網(wǎng)。關(guān)鍵看 NetworkAccess 枚舉:
- NetworkAccess.Internet:設(shè)備可訪問公網(wǎng)(如能打開 google.com)
- NetworkAccess.Local:僅局域網(wǎng)通(比如連了 WiFi 但沒網(wǎng)關(guān)/沒外網(wǎng))
- NetworkAccess.None:完全無網(wǎng)絡(luò)連接
用法很簡單:
1 2 3 4 5 6 7 | var access = Connectivity.Current.NetworkAccess;
if (access == NetworkAccess.Internet)
Console.WriteLine("在線,可發(fā)起 API 請求");
else if (access == NetworkAccess.Local)
Console.WriteLine("在內(nèi)網(wǎng),可能無法訪問云服務(wù)");
else
Console.WriteLine("離線中");
|
實時監(jiān)聽網(wǎng)絡(luò)變化事件
別輪詢,用 Connectivity.ConnectivityChanged 事件——只要網(wǎng)絡(luò)狀態(tài)一變(比如斷網(wǎng)、切 WiFi、開啟飛行模式),就會觸發(fā):
1 2 3 4 5 6 7 8 9 10 11 12 13 | // 建議在頁面或服務(wù)生命周期開始時注冊
Connectivity.ConnectivityChanged += OnConnectivityChanged;
void OnConnectivityChanged(object sender, ConnectivityChangedEventArgs e)
{
var newAccess = e.NetworkAccess;
var profile = e.ConnectionProfiles; // 如 [Wifi], [Cellular]
if (newAccess == NetworkAccess.Internet)
ShowOnlineToast();
else
ShowOfflineHint();
}
|
?? 注意:該事件是全局的,記得在頁面銷毀或服務(wù)停用時反注冊,避免內(nèi)存泄漏:
1 | Connectivity.ConnectivityChanged -= OnConnectivityChanged;
|
區(qū)分網(wǎng)絡(luò)類型(WiFi / 蜂窩 / 以太網(wǎng))
如果業(yè)務(wù)需要按網(wǎng)絡(luò)類型做策略(例如只在 WiFi 下自動更新),用 ConnectionProfiles:
- ConnectionProfile.WiFi
- ConnectionProfile.Cellular
- ConnectionProfile.Ethernet
- ConnectionProfile.Unknown
示例判斷是否在 WiFi:
1 | bool isOnWifi = Connectivity.Current.ConnectionProfiles.Contains(ConnectionProfile.WiFi);
|
注意:多個 profile 可能同時存在(如 WiFi + 藍牙 PAN),所以要用 Contains 而非直接比對。
離線場景下的實用建議
真實用戶場景中,光知道“離線”還不夠,還得處理得自然:
- 界面層加個輕量提示條(非彈窗),2 秒后自動收起
- API 請求失敗時,先檢查
Connectivity.Current.NetworkAccess,再決定重試 or 緩存隊列 - 本地數(shù)據(jù)庫操作照常執(zhí)行,等聯(lián)網(wǎng)后再同步(配合 依賴注入 封裝同步邏輯)
- iOS 模擬器偶爾返回不準(zhǔn)確狀態(tài),真機測試更可靠
基本上就這些。Connectivity API 設(shè)計簡潔,重點是把 NetworkAccess 和 ConnectionProfiles 的語義理解清楚,別把它當(dāng)成“是否有信號”來用。
“MAUI怎么監(jiān)聽網(wǎng)絡(luò)狀態(tài)變化 MAUI Connectivity教程” 的相關(guān)文章