Flutter系统状态监控插件system_state的使用

SystemState 是一个为 Flutter 设计的插件，旨在提供对设备状态和控制的访问。目前，该插件主要支持 Android 平台。它允许你监控和控制电池、音量、Wi-Fi 和移动数据的状态。未来版本将扩展功能并支持更多平台。

功能

• 电池状态监控：获取并监听电池电量、温度和充电状态。
• 音量控制：获取当前系统音量，设置新的音量级别，并监听音量变化。
• Wi-Fi 状态监控与控制：
  • 检查 Wi-Fi 是否已启用或连接。
  • 获取已连接的 Wi-Fi 网络名称（connectedWifiName）。
  • 监听 Wi-Fi 状态变化。
• 移动数据状态监控与控制：
  • 检查移动数据是否已启用。
  • 获取 SIM 运营商名称、网络运营商和网络类型（如 4G、5G）。
  • 监听移动数据状态变化。

注意：目前，SystemState 仅支持 Android 平台。平台检查确保在不支持的平台上会抛出异常。未来的版本将包括对 iOS、Web 等平台的支持。

安装

要安装该插件，在你的 pubspec.yaml 文件中添加以下依赖：

dependencies:
  system_state: ^1.2.6

然后运行以下命令来安装包：

flutter pub get

权限

为了访问和控制各种系统状态，你需要在 AndroidManifest.xml 文件中添加以下权限：

音量控制

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

Wi-Fi 状态

• 要读取 Wi-Fi 和网络状态：

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

• 要切换 Wi-Fi 状态：

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

• 要查看已连接的 Wi-Fi 名称（SSID），还需要添加以下权限并确保设备上的位置服务已启用：

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

移动数据状态

• 要检查网络状态并获取运营商信息：

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

使用

导入包

在 Dart 代码中导入 system_state 包：

import 'package:system_state/system_state.dart';

移动数据状态监控

使用 SystemState.mobileData 来访问移动数据相关的功能。

获取移动数据状态

Future<void> getMobileDataState() async {
  try {
    final mobileDataState = await SystemState.mobileData.getMobileDataState();
    print("移动数据已启用: ${mobileDataState.isMobileDataEnabled}");
    print("网络运营商: ${mobileDataState.networkOperator}");
    print("网络类型: ${mobileDataState.networkType}");
  } catch (e) {
    print("获取移动数据状态时发生错误: $e");
  }
}

监听移动数据状态变化

void listenMobileDataState() {
  SystemState.mobileData.listen((mobileDataState) {
    print("移动数据已更改 - 已启用: ${mobileDataState.isMobileDataEnabled}, 运营商: ${mobileDataState.networkOperator}, 网络类型: ${mobileDataState.networkType}");
  });
}

电池、音量和 Wi-Fi 功能

有关电池监控、音量控制和 Wi-Fi 状态控制的详细信息，请参阅官方文档的相关部分。

API 参考

• MobileData.getMobileDataState()：获取当前移动数据状态，包括运营商名称和网络类型。
• MobileData.listen(void Function(MobileDataState) callback)：监听移动数据状态的变化。
• Battery、Volume 和 Wi-Fi 方法保持不变。

平台支持

注意：平台检查确保在非 Android 平台上插件会抛出异常。未来的版本将努力支持更多平台，包括 iOS 和 Web。

未来开发

SystemState 正在积极开发中。未来更新将引入：

• 网络控制器：管理飞行模式和蓝牙状态的功能。
• 跨平台支持：计划支持 iOS、Web 和其他平台。

贡献

我们欢迎贡献！如果你有任何想法或建议，请随时提交问题或拉取请求。

许可证

该项目受 MIT 许可证保护。

示例代码

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

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'SystemState Example',
      theme: ThemeData(primarySwatch: Colors.blue),
      home: const SystemStateHomePage(),
    );
  }
}

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

  [@override](/user/override)
  _SystemStateHomePageState createState() => _SystemStateHomePageState();
}

class _SystemStateHomePageState extends State<SystemStateHomePage> {
  BatteryState? _batteryState;
  VolumeState? _volumeState;
  WifiState? _wifiState;

  bool _isBatteryLoading = false;
  bool _isVolumeLoading = false;
  bool _isWifiLoading = false;

  [@override](/user/override)
  void initState() {
    super.initState();
    _fetchAllStates();
  }

  Future<void> _fetchAllStates() async {
    _getBatteryState();
    _getVolumeState();
    _getWifiState();
  }

  Future<void> _getBatteryState() async {
    setState(() => _isBatteryLoading = true);
    try {
      final batteryState = await SystemState.battery.getBattery();
      setState(() => _batteryState = batteryState);
    } catch (e) {
      print("获取电池状态时发生错误: $e");
    } finally {
      setState(() => _isBatteryLoading = false);
    }
  }

  Future<void> _getVolumeState() async {
    setState(() => _isVolumeLoading = true);
    try {
      final volumeState = await SystemState.volume.getVolume();
      setState(() => _volumeState = volumeState);
    } catch (e) {
      print("获取音量状态时发生错误: $e");
    } finally {
      setState(() => _isVolumeLoading = false);
    }
  }

  Future<void> _getWifiState() async {
    setState(() => _isWifiLoading = true);
    try {
      final wifiState = await SystemState.wifi.getWifi();
      setState(() => _wifiState = wifiState);
    } catch (e) {
      print("获取 Wi-Fi 状态时发生错误: $e");
    } finally {
      setState(() => _isWifiLoading = false);
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('SystemState Example'),
      ),
      body: Padding(
        padding: const EdgeInsets.all(16.0),
        child: Column(
          children: [
            // 电池部分
            ListTile(
              title: const Text("电池"),
              subtitle: _isBatteryLoading
                  ? const CircularProgressIndicator()
                  : Text(_batteryState != null
                      ? "电量: ${_batteryState!.level}%"
                      : "电池数据不可用"),
              trailing: ElevatedButton(
                onPressed: _getBatteryState,
                child: const Text("刷新"),
              ),
            ),
            const Divider(),

            // 音量部分
            ListTile(
              title: const Text("音量"),
              subtitle: _isVolumeLoading
                  ? const CircularProgressIndicator()
                  : Text(_volumeState != null
                      ? "当前音量: ${_volumeState!.level}"
                      : "音量数据不可用"),
              trailing: ElevatedButton(
                onPressed: _getVolumeState,
                child: const Text("刷新"),
              ),
            ),
            const Divider(),

            // Wi-Fi 部分
            ListTile(
              title: const Text("Wi-Fi"),
              subtitle: _isWifiLoading
                  ? const CircularProgressIndicator()
                  : Text(_wifiState != null
                      ? _wifiState!.isEnabled
                          ? "连接到 ${_wifiState!.connectedWifiName ?? '未知网络'}"
                          : "Wi-Fi 已禁用"
                      : "Wi-Fi 数据不可用"),
              trailing: ElevatedButton(
                onPressed: _getWifiState,
                child: const Text("刷新"),
              ),
            ),
          ],
        ),
      ),
    );
  }
}