Flutter网络连接类型检测插件connection_network_type的使用

connection_network_type

此插件允许Flutter应用程序检测网络变化。您可以了解详细的移动网络类型，如2G、3G、4G、5G。这个插件适用于iOS和Android，它还可以检测互联网连接状态是否真实有效，或者是否不稳定。

这个库是基于并受到"network_type_reachability"库的启发，而"network_type_reachability"又基于并受到"flutter_reachability"库的启发。

主要的区别在于代码已经被重构以移除管理权限的需求，并且解决了类型问题。这样，这个库虽然包含的功能较少，但在不同版本中保持了更大的兼容性。

Examples 示例

1. 检测当前网络类型

// 如果此插件用于Android，请请求READ_PHONE_STATE权限。
if(Platform.isAndroid) {
    await Permission.phone.request();
}

NetworkStatus networkStatus = await ConnectionNetworkType().currentNetworkStatus();

switch(networkStatus) {
  case NetworkStatus.unreachable:
    // 网络不可达
  case NetworkStatus.wifi:
    // WiFi连接
  case NetworkStatus.mobile2G:
    // 2G连接
  case NetworkStatus.mobile3G:
    // 3G连接
  case NetworkStatus.mobile4G:
    // 4G连接
  case NetworkStatus.mobile5G:
    // 5G连接
  case NetworkStatus.otherMoblie:
    // 其他移动连接
}

2. 监听网络类型的变化

ConnectionNetworkType().onNetworkStateChanged.listen((NetworkStatus networkStatus) {
  // 在这里触发一个函数或管理状态
});

Getting Started 快速开始

本项目是一个Flutter插件包的起点，专门针对包括Android和/或iOS平台特定实现代码的包。

要开始Flutter开发，请参阅官方文档，其中提供了教程、示例、移动开发指南以及完整的API参考。

完整示例Demo

下面是一个完整的示例，展示了如何在Flutter应用中使用connection_network_type插件来检测和监听网络状态的变化：

import 'dart:async';

import 'package:connection_network_type/connection_network_type.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
}

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

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String _networkStatus = NetworkStatus.unreachable.name;
  final ConnectionNetworkType _connectionNetworkTypePlugin =
      ConnectionNetworkType();

  @override
  void initState() {
    super.initState();
    initPlatformState();
    initPlatformNetworkListen();
  }

  // 平台消息是异步的，因此我们在异步方法中初始化。
  Future<void> initPlatformState() async {
    // 在Android上使用此插件需要READ_PHONE_STATE权限
    // 如果在Android发布版本中使用此插件，请记住请求READ_PHONE_STATE权限
    // 我们建议您使用`permission_handler`包，如下所示

    // if(Platform.isAndroid) {
    //   Permission.phone.request();
    // }

    late NetworkStatus networkStatus;
    // 平台消息可能会失败，所以我们用try/catch处理PlatformException。
    // 我们还处理消息可能返回null的情况。
    try {
      networkStatus = await _connectionNetworkTypePlugin.currentNetworkStatus();
    } on PlatformException {
      networkStatus = NetworkStatus.unreachable;
    }

    // 如果小部件在异步平台消息飞行时被从树中移除，
    // 我们希望丢弃回复而不是调用setState更新我们不存在的外观。
    if (!mounted) return;

    setState(() {
      _networkStatus = networkStatus.name;
    });
  }

  void initPlatformNetworkListen() {
    _connectionNetworkTypePlugin.onNetworkStateChanged.listen((NetworkStatus networkStatus) {
      if (networkStatus.name != _networkStatus) {
        // 如果小部件在异步平台消息飞行时被从树中移除，
        // 我们希望丢弃回复而不是调用setState更新我们不存在的外观。
        if (!mounted) return;

        setState(() {
          _networkStatus = networkStatus.name;
        });
      }
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Center(
          child: Text('Running on: $_networkStatus\n'),
        ),
      ),
    );
  }
}

以上就是connection_network_type插件的基本使用方法，通过上述代码，您可以轻松地在Flutter应用中实现对网络类型的检测和监听功能。