Flutter屏幕截图插件device_screenshot的使用

概述

Device Screenshot 是一个 Flutter 插件，可以帮助你通过媒体投影和前台服务来截取整个设备的屏幕。该插件目前仅支持 Android，并且不支持 iOS，因为媒体投影功能在 iOS 上不可用。

使用

首先，在你的 pubspec.yaml 文件中添加 device_screenshot 作为依赖项：

dependencies:
  flutter:
    sdk: flutter

  device_screenshot: ^update_version

然后运行 flutter pub get 来获取新的依赖项。

设置

将最低 SDK 版本设置为 21 或更高版本。在你的 android/app/build.gradle 文件中进行如下设置：

android {
    defaultConfig {
        ...
        minSdkVersion 21 // 设置为 21 或更高版本
        ...
    }
}

在 AndroidManifest.xml 文件中添加如下配置：

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

  <application
        ...
        ...>

        <activity
            ...
            ...>

        <!-- 添加此部分 -->
        <service
            android:name="com.flutter.device_screenshot.src.MediaProjectionService"
            android:enabled="true"
            android:exported="false"
            android:foregroundServiceType="mediaProjection"
            android:permission="TODO"
            android:stopWithTask="false"
            />
        <!-- 结束 -->

        ...
  ...
  </application>
</manifest>

导入包：

import 'package:device_screenshot/device_screenshot.dart';

使用单例实例 DeviceScreenshot 访问所有可用方法，例如：

DeviceScreenshot.instance.checkMediaProjectionService()

截图

首先你需要启动前台服务，为此可以调用：

DeviceScreenshot.instance.requestMediaProjection()

现在你已经准备好截取屏幕了。你可以调用以下方法来截取屏幕并保存截图路径：

Uri? uri = await DeviceScreenshot.instance.takeScreenshot()

完整示例代码

下面是完整的示例代码，展示了如何使用 device_screenshot 插件来检查、请求和停止媒体投影服务，并截取屏幕。

import 'package:device_screenshot_example/example_button.dart';
import 'package:flutter/material.dart';

import 'package:device_screenshot/device_screenshot.dart';

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

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

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

class _MyAppState extends State<MyApp> {
  String message = "";

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Padding(
          padding: const EdgeInsets.all(24),
          child: Center(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              crossAxisAlignment: CrossAxisAlignment.center,
              children: [
                Expanded(
                  child: Center(
                    child: SelectableText(
                      message,
                      style: Theme.of(context).textTheme.headlineSmall,
                      textAlign: TextAlign.center,
                    ),
                  ),
                ),
                ExampleButton(
                  onPressed: () async {
                    bool mediaProjectionService = await DeviceScreenshot.instance.checkMediaProjectionService();
                    setState(() {
                      message = 'Media projection service status: $mediaProjectionService';
                    });
                  },
                  title: '检查媒体投影服务状态',
                ),
                ExampleButton(
                  onPressed: () async {
                    if (!await DeviceScreenshot.instance.checkMediaProjectionService()) {
                      DeviceScreenshot.instance.requestMediaProjection();
                    }
                  },
                  title: '请求媒体投影服务',
                ),
                ExampleButton(
                  onPressed: () async {
                    if (await DeviceScreenshot.instance.checkMediaProjectionService()) {
                      DeviceScreenshot.instance.stopMediaProjectionService();
                    }
                  },
                  title: '停止媒体投影服务',
                ),
                ExampleButton(
                  onPressed: () async {
                    Uri? uri = await DeviceScreenshot.instance.takeScreenshot();
                    if (uri != null) {
                      setState(() {
                        message = uri.path;
                      });
                    } else {
                      setState(() {
                        message = '截图路径为空！';
                      });
                    }
                  },
                  title: '截取屏幕',
                ),
              ],
            ),
          ),
        ),
      ),
    );
  }
}