Flutter网络连接状态检测插件 connectivity_widget 的使用

connectivity_widget 是一个用于检测手机是否连接到互联网的Flutter插件。它不仅通过检查移动网络和/或Wi-Fi的状态来确定连接状态，还会通过ping远程服务器并验证其响应来确认网络连接。

使用 ConnectivityWidget

ConnectivityWidget 使用一个 builder 函数，该函数提供了一个 isOnline 标志，用于构建不同的离线或在线模式界面。

示例代码

import 'package:flutter/material.dart';
import 'package:connectivity_widget/connectivity_widget.dart';

void main() {
  /// 设置 Connectivity Utils
  ConnectivityUtils.instance
    ..serverToPing =
        "https://gist.githubusercontent.com/Vanethos/dccc4b4605fc5c5aa4b9153dacc7391c/raw/355ccc0e06d0f84fdbdc83f5b8106065539d9781/gistfile1.txt"
    ..verifyResponseCallback =
        (response) => response.contains("This is a test!");

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Connectivity Widget Demo'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({required this.title, super.key});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: ConnectivityWidget(
        onlineCallback: _incrementCounter,
        builder: (context, isOnline) => Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              Text(
                isOnline ? 'Online' : 'Offline',
                style: TextStyle(
                    fontSize: 30, color: isOnline ? Colors.green : Colors.red),
              ),
              const SizedBox(
                height: 20,
              ),
              const Text(
                'Number of times we checked internet connection:',
              ),
              Text(
                '$_counter',
                style: Theme.of(context).textTheme.displayLarge,
              ),
            ],
          ),
        ),
      ),
    );
  }
}

参数配置

• serverToPing: 指定要ping的服务器地址。
• timeoutDuration: 设置请求超时时间。
• debounceDuration: 设置防抖动时间。
• verifyResponseCallback: 自定义回调函数，用于验证服务器响应。

更改要ping的服务器和响应验证

默认情况下，ConnectivityWidget 会检查是否连接到 http://www.google.com。如果需要检查自定义端点的可用性，可以设置新的端点并提供一个回调函数来验证响应。

ConnectivityUtils.instance.setCallback((response) => response.contains("This is a test!"));
ConnectivityUtils.instance.setServerToPing("https://gist.githubusercontent.com/Vanethos/dccc4b4605fc5c5aa4b9153dacc7391c/raw/355ccc0e06d0f84fdbdc83f5b8106065539d9781/gistfile1.txt");

使用 ConnectivityUtils 监听网络变化

该库还提供了对 ConnectivityUtils 类的访问，可以通过它来验证网络状态。

Stream<bool> ConnectivityUtils.instance.isPhoneConnectedStream // 获取当前网络状态
Future<bool> ConnectivityUtils.instance.isPhoneConnected() // 确定网络状态的未来

Web环境下的注意事项

虽然可以在Web环境下验证连接状态，但由于浏览器会对特定端点的请求进行缓存，因此无法确切地判断连接是否断开或正在使用缓存。

通过以上示例和说明，您可以轻松在Flutter项目中集成并使用 connectivity_widget 插件来检测网络连接状态。