Flutter设备管理插件device_kit的使用

简介

device_kit 是一个用于在 Flutter 应用中访问设备信息和功能的插件。它提供了多种设备相关的操作，如获取设备 ID、亮度控制、代理设置等。

功能特性

• 获取设备的 Android ID 和设备 ID。
• 控制屏幕亮度。
• 检查设备是否正在充电或 SIM 卡是否已挂载。
• 设置屏幕保护状态。
• 获取设备的时区和语言环境。
• 获取网络代理设置。

使用步骤

1. 添加依赖

在 pubspec.yaml 文件中添加 device_kit 依赖：

dependencies:
  device_kit: ^版本号

然后运行以下命令以安装依赖：

flutter pub get

2. 配置 Android 权限

在 AndroidManifest.xml 文件中移除不必要的权限：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <!-- device_kit -->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" tools:node="remove" />
</manifest>

3. 示例代码

以下是一个完整的示例代码，展示了如何使用 device_kit 插件来访问设备信息和功能。

import 'dart:async';
import 'dart:io';

import 'package:device_kit/device_kit.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late final StreamSubscription<double> _brightnessChangedResp;
  StreamSubscription<String>? _takeScreenshotResp;
  StreamSubscription<String>? _capturedChangedResp;
  bool _secure = false;

  [@override](/user/override)
  void initState() {
    super.initState();
    // 监听屏幕亮度变化
    _brightnessChangedResp =
        Device.instance.brightnessChangedStream().listen((double event) {
      if (kDebugMode) {
        print('Brightness Changed: $event');
      }
    });
    if (Platform.isIOS) {
      // 监听截图事件（仅适用于 iOS）
      _takeScreenshotResp =
          Device.instance.takeScreenshotStream().listen((String event) {
        if (kDebugMode) {
          print('Take Screenshot: $event');
        }
      });
      // 监听捕获状态变化（仅适用于 iOS）
      _capturedChangedResp =
          Device.instance.capturedChangedStream().listen((String event) {
        if (kDebugMode) {
          print('Captured Changed: $event');
        }
      });
    }
  }

  [@override](/user/override)
  void dispose() {
    _capturedChangedResp?.cancel();
    _takeScreenshotResp?.cancel();
    _brightnessChangedResp.cancel();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Device Kit'),
        ),
        body: ListView(
          children: [
            if (Platform.isAndroid)
              ListTile(
                title: Text('获取 Android ID'),
                onTap: () async {
                  if (kDebugMode) {
                    print(
                        'Android Id: ${await Device.instance.getAndroidId()}');
                  }
                },
              ),
            if (Platform.isAndroid)
              ListTile(
                title: Text('获取设备 ID'),
                onTap: () async {
                  if (kDebugMode) {
                    print('Device Id: ${await Device.instance.getDeviceId()}');
                  }
                },
              ),
            if (Platform.isAndroid)
              ListTile(
                title: Text('获取 MAC 地址'),
                onTap: () async {
                  if (kDebugMode) {
                    print('Mac: ${await Device.instance.getMac()}');
                  }
                },
              ),
            ListTile(
              title: Text('检查设备是否正在充电'),
              onTap: () async {
                if (kDebugMode) {
                  print('isCharging: ${await Device.instance.isCharging()}');
                }
              },
            ),
            ListTile(
              title: Text('检查 SIM 卡是否已挂载'),
              onTap: () async {
                if (kDebugMode) {
                  print(
                      'isSimMounted: ${await Device.instance.isSimMounted()}');
                }
              },
            ),
            ListTile(
              title: Text('检查是否开启了 VPN'),
              onTap: () async {
                if (kDebugMode) {
                  print('isVPNOn: ${await Device.instance.isVPNOn()}');
                }
              },
            ),
            ListTile(
              title: Text('获取语言环境'),
              onTap: () {
                if (kDebugMode) {
                  print('localeName: ${Platform.localeName}');
                }
              },
            ),
            ListTile(
              title: Text('获取时区'),
              onTap: () {
                if (kDebugMode) {
                  print(
                      'timeZone: ${DateTime.now().timeZoneName} - ${DateTime.now().timeZoneOffset}');
                }
              },
            ),
            ListTile(
              title: Text('获取代理设置'),
              onTap: () async {
                if (kDebugMode) {
                  print('proxy: ${await Device.instance.getProxy()}');
                }
              },
            ),
            ListTile(
              title: Text('获取当前亮度'),
              onTap: () async {
                if (kDebugMode) {
                  print('brightness: ${await Device.instance.getBrightness()}');
                }
              },
            ),
            ListTile(
              title: Text('设置亮度为 0.5'),
              onTap: () async {
                if (kDebugMode) {
                  await Device.instance.setBrightness(0.5);
                }
              },
            ),
            if (Platform.isAndroid)
              ListTile(
                title: Text('设置屏幕保护状态'),
                onTap: () {
                  _secure = !_secure;
                  Device.instance.setSecureScreen(_secure);
                },
              ),
          ],
        ),
      ),
    );
  }
}