搜尋套件、儲存庫與 APP 分類

flutter_network_connectivity 封面
套件詳情v0.0.6

flutter_network_connectivity

一個用於檢查即時網路連線狀態的 Flutter 外掛。此外掛在 Android 上使用 NetworkCapabilities,在 iOS 上使用 NetworkMonitor。

AndroidiOS
近 30 天下載
270
喜歡數
43
Pub 分數
140

安裝套件

flutter pub add flutter_network_connectivity

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

一個 Flutter 外掛程式,可於 Android 與 iOS 裝置上實現網路連線狀態的即時監控。它利用原生系統 API——Android 上的 NetworkCapabilities 與 iOS 上的 NetworkMonitor,提供準確、即時的裝置是否已連接至網際網路的資訊。此外掛程式輕巧且設計用於無縫整合至需要網路感知功能的應用中,例如根據連線可用性調整行為的應用。支援 Wi-Fi 與行動數據檢測,並在連線狀態變更時發出事件。

適用情境

  • 即時網路狀態檢查
  • 離線模式處理
  • 基於連接性的動態UI更新
  • 背景連接監控
  • 應用在網路波動期間的彈性

主要特色

  • 跨平台支援(Android 與 iOS)
  • 使用原生系統 API 以確保準確性
  • 即時連接事件發射
  • 輕量且易於整合
  • 支援Wi-Fi和行動數據檢測

適合對象

  • 需要網路感知的應用程式
  • 離線可用的應用程式
  • 後台服務整合
  • 基於連接性的使用者體驗優化
  • 尋求可靠連接檢查的開發者

使用建議

  • 需要平台特定權限
  • 可能無法偵測所有邊緣情況,例如俘虜門檻
  • 僅限連接狀態,不包含頻寬或品質
  • 依賴原生實作的穩定性
  • 連接失敗時無內建重試邏輯

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

Flutter Network Connectivity

Pub

A flutter plugin to check for Internet Availability as a stream based on network connectivity status, periodic interval or on call.

Usage

First, add flutter_network_connectivity as a dependency in your pubspec.yaml file.

dependencies:
  flutter_network_connectivity: ^0.0.6

Don't forget to flutter pub get.

Then import:

import 'package:flutter_network_connectivity/flutter_network_connectivity.dart';

Now you can create FlutterNetworkConnectivity object and use its methods

FlutterNetworkConnectivity flutterNetworkConnectivity =
    FlutterNetworkConnectivity(
	  isContinousLookUp: true,  // optional, false if you don't want continous lookup
	  lookUpDuration: const Duration(seconds: 5),  // optional, to override default lookup duration
	  lookUpUrl: 'example.com',  // optional, to override default lookup url
	);
To Check for Stream of Network Connectivity Status
_flutterNetworkConnectivity.getInternetAvailabilityStream().listen((isInternetAvailable) {
  // do something
});

Then Register Availability Listener after setting up Stream Listerer

await _flutterNetworkConnectivity.registerAvailabilityListener();

Unregister on dispose

await _flutterNetworkConnectivity.unregisterAvailabilityListener();
To Check for Internet Availability on Call
bool _isNetworkConnectedOnCall = await
    _flutterNetworkConnectivity.isInternetConnectionAvailable();
Examples

Simple usage example can be found in the example folder.

Android

Uses permission

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Minimum SDK Version 16

iOS

Uses NetworkMonitor, minimum required version 12.0

Demo

Screenshot

About

This plugin uses NetworkCapabilities for Android and NetworkMonitor for iOS to check for network connectivity status.

Contributing?

You're always welcome. See Contributing Guidelines. You can also take a look at Status Tracker to know more information about current or pending features/issues.

所屬分類

原始碼儲存庫

使用此套件的專案

暫無相關資料。