Flutter屏幕录制插件tt_screen_record_plugin的使用

tt_screen_record_plugin

屏幕录制组件支持Android和iOS。Android使用的是device_screen_recorder插件。iOS使用的系统能力是ReplayKit。只有在iOS14（包括14）及以上版本才能将录制的视频保存到自定义路径，例如沙盒。在iOS14之前，录制的视频会保存在照片图库。

这是一个新的Flutter插件，用于记录屏幕。该插件要求Android SDK 21+ 和 iOS 10+。

开始使用

该插件可用于在Android和iOS设备上录制屏幕。

1 初始化

final _ttScreenRecordPlugin = TtScreenRecordPlugin();

2 开始录制

bool result = await _ttScreenRecordPlugin.startRecording();

3 停止录制

Map result = await _ttScreenRecordPlugin.stopRecording();

4 判断是否正在录制

bool recording = await _ttScreenRecordPlugin.recording();

5 判断设备是否支持录制（仅适用于iOS，Android默认返回true）

final _result = await _ttScreenRecordPlugin.isAvailable();

Android

flutter_screen_recorder 不需要请求必要的权限。你可以使用 permission_handler 这个权限插件。在你的 AndroidManifest.xml 中添加以下权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_INTERNAL_STORAGE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />

在最新的Android版本中，录制屏幕需要使用一个前台服务，我们添加了 flutter_foreground_plugin 插件。

iOS

你只需要在 Info.plist 中添加权限消息：

<key>NSPhotoLibraryUsageDescription</key>
<string>Save video in gallery</string>
<key>NSMicrophoneUsageDescription</key>
<string>Save audio in video</string>

完整示例

以下是一个完整的示例代码，展示了如何使用 tt_screen_record_plugin 插件来实现屏幕录制功能。

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

import 'package:flutter/services.dart';
import 'package:tt_screen_record_plugin/tt_screen_record_plugin.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 _platformVersion = 'Unknown';
  final _ttScreenRecordPlugin = TtScreenRecordPlugin();
  bool recording = false; // 是否正在录制
  int recordingText = 0;
  Timer? _timer;

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

  // 平台消息异步，所以我们在异步方法中初始化。
  Future<void> initPlatformState() async {
    String platformVersion;
    // 平台消息可能失败，所以我们使用try/catch处理PlatformException。
    // 我们还处理消息可能返回null的情况。
    try {
      final _result = await _ttScreenRecordPlugin.isAvailable();
      print('platformVersion=${_result}');
      platformVersion = _result.toString();
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

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

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Container(
          width: MediaQuery.of(context).size.width,
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: () async {
                  // 按钮点击事件
                  bool result = await _ttScreenRecordPlugin.startRecording();
                  recording = await _ttScreenRecordPlugin.recording();
                  if (result) {
                    _timer = Timer.periodic(Duration(seconds: 1), (timer) {
                      recordingText++;
                      setState(() {});
                    });
                  }
                },
                child: Text('开始'),
              ),
              SizedBox(
                height: 16,
              ),
              ElevatedButton(
                onPressed: () async {
                  // 按钮点击事件
                  Map result = await _ttScreenRecordPlugin.stopRecording();
                  print('result=${result['success']}');
                  recording = await _ttScreenRecordPlugin.recording();
                  _timer?.cancel();
                  recordingText = 0;
                  setState(() {});
                },
                child: Text('停止'),
              ),
              Row(
                mainAxisAlignment: MainAxisAlignment.start,
                children: [
                  Text('录制状态:'),
                  SizedBox(
                    width: 32,
                  ),
                  Text(recording ? '正在录制' : '空闲'),
                ],
              ),
              SizedBox(
                height: 16,
              ),
              Text(
                recordingText.toString(),
                style: TextStyle(fontWeight: FontWeight.bold, fontSize: 30),
              ),
            ],
          ),
        ),
      ),
    );
  }
}