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

fconnectivity 是一个用于检查互联网连接状态的Flutter包。它允许开发者轻松管理和响应应用程序中的互联网访问状态变化。

使用方法

监听互联网访问状态的变化

你可以使用 InternetAccessConsumer 小部件或 InternetAccessListener 类来监听互联网访问状态的变化。

示例1：使用 InternetAccessConsumer

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

void main() => runApp(
  MaterialApp(
    home: Scaffold(
      body: InternetAccessConsumer(
        onInternetAccessGained: (context) => print('Internet access gained'),
        onInternetAccessLost: (context) => print('Internet access lost'),
        builder: (context, hasInternetAccess) => Text(
          'Internet access state: ${hasInternetAccess ? 'Available' : 'Not Available'}',
        ),
      ),
    ),
  ),
);

示例2：使用 InternetAccessListener

@override
Widget build(BuildContext context) {
  return InternetAccessListener(
    onInternetAccessGained: (context) => print('Internet access gained'),
    onInternetAccessLost: (context) => print('Internet access lost'),
    child: YourWidget(), // 替换为你的小部件
  );
}

示例3：使用 InternetAccessBuilder

@override
Widget build(BuildContext context) {
  return InternetAccessBuilder(
    builder: (context, hasInternetAccess) => Text(
      'Internet access state: ${hasInternetAccess ? 'Available' : 'Not Available'}',
    ),
  );
}

配置互联网访问检查过程

你可以通过使用 InternetAccessChecker 类来配置互联网访问检查过程。

示例：

// 手动触发互联网访问检查并通知监听器结果。
InternetAccessChecker.instance.triggerInternetAccessCheck();

// 设置周期性互联网访问检查的新间隔。
InternetAccessChecker.instance.setInternetAccessCheckInterval(Duration(seconds: 10));

// 设置在发生连接变化后进行互联网访问检查的延迟。
InternetAccessChecker.instance.setPostConnectivityChangeCheckDelay(Duration(seconds: 1));

释放资源

如果你不再想使用互联网访问检查，可以通过以下方式释放资源：

// 释放服务使用的资源。
InternetAccessChecker.instance.dispose();

注意：调用 dispose() 方法后，你不能再使用该包。

注意事项

• 在你开始使用监听器小部件（如 InternetAccessConsumer 或 InternetAccessListener）监听互联网访问状态变化之前，该包不会使用任何资源。

完整示例代码

下面是一个完整的示例代码，展示了如何在Flutter应用中使用 fconnectivity 包。

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

void main() => runApp(
  MaterialApp(
    home: Scaffold(
      body: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          InternetAccessConsumer(
            onInternetAccessGained: (BuildContext context) => debugPrint(
              'Internet access gained (logged by InternetAccessConsumer)',
            ),
            onInternetAccessLost: (BuildContext context) => debugPrint(
              'Internet access lost (logged by InternetAccessConsumer)',
            ),
            builder: ({
              required BuildContext context,
              required bool hasInternetAccess,
            }) =>
                Text(
              'This text widget rebuilds when internet access state changes. Current state of internet access: ${hasInternetAccess ? 'Available' : 'Not Available'}',
              textAlign: TextAlign.center,
            ),
          ),
          const SizedBox(height: 20),
          InternetAccessListener(
            onInternetAccessGained: (BuildContext context) => debugPrint(
              'Internet access gained (logged by InternetAccessListener)',
            ),
            onInternetAccessLost: (BuildContext context) => debugPrint(
              'Internet access lost (logged by InternetAccessListener)',
            ),
            child: const Text(
              'This text widget does not rebuild when internet access state changes.',
              textAlign: TextAlign.center,
            ),
          ),
        ],
      ),
    ),
  ),
);