animagie_video_editor 是一个 Flutter 插件，用于在移动应用中实现视频编辑功能。它提供了一系列功能，如裁剪、旋转、添加滤镜、添加文本、添加音乐等。以下是如何在 Flutter 项目中使用 animagie_video_editor 插件的详细步骤。

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 animagie_video_editor 插件的依赖。

dependencies:
  flutter:
    sdk: flutter
  animagie_video_editor: ^1.0.0  # 请确保使用最新版本

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

2. 导入插件

在需要使用视频编辑功能的地方，导入 animagie_video_editor 插件。

import 'package:animagie_video_editor/animagie_video_editor.dart';

3. 初始化插件

你可以通过创建一个 AnimagieVideoEditor 实例来初始化插件。

final animagieVideoEditor = AnimagieVideoEditor();

4. 使用视频编辑功能

以下是一些常见的视频编辑功能的用法示例。

裁剪视频

Future<void> cropVideo(String inputPath, String outputPath) async {
  try {
    await animagieVideoEditor.cropVideo(
      inputPath: inputPath,
      outputPath: outputPath,
      startTime: Duration(seconds: 2), // 开始时间
      endTime: Duration(seconds: 10),  // 结束时间
    );
    print('Video cropped successfully');
  } catch (e) {
    print('Failed to crop video: $e');
  }
}

旋转视频

Future<void> rotateVideo(String inputPath, String outputPath) async {
  try {
    await animagieVideoEditor.rotateVideo(
      inputPath: inputPath,
      outputPath: outputPath,
      rotation: 90,  // 旋转角度 (90, 180, 270)
    );
    print('Video rotated successfully');
  } catch (e) {
    print('Failed to rotate video: $e');
  }
}

添加滤镜

Future<void> applyFilter(String inputPath, String outputPath) async {
  try {
    await animagieVideoEditor.applyFilter(
      inputPath: inputPath,
      outputPath: outputPath,
      filterType: FilterType.sepia,  // 滤镜类型
    );
    print('Filter applied successfully');
  } catch (e) {
    print('Failed to apply filter: $e');
  }
}

添加文本

Future<void> addText(String inputPath, String outputPath) async {
  try {
    await animagieVideoEditor.addText(
      inputPath: inputPath,
      outputPath: outputPath,
      text: 'Hello, World!',
      position: TextPosition.center,  // 文本位置
      textStyle: TextStyle(
        color: Colors.white,
        fontSize: 24,
      ),
    );
    print('Text added successfully');
  } catch (e) {
    print('Failed to add text: $e');
  }
}

添加音乐

Future<void> addMusic(String videoPath, String audioPath, String outputPath) async {
  try {
    await animagieVideoEditor.addMusic(
      videoPath: videoPath,
      audioPath: audioPath,
      outputPath: outputPath,
    );
    print('Music added successfully');
  } catch (e) {
    print('Failed to add music: $e');
  }
}

5. 处理权限

在使用视频编辑功能之前，确保你已经获取了必要的权限，如读取和写入存储的权限。

import 'package:permission_handler/permission_handler.dart';

Future<void> requestPermissions() async {
  var status = await Permission.storage.status;
  if (!status.isGranted) {
    await Permission.storage.request();
  }
}

6. 完整示例

以下是一个简单的完整示例，展示如何使用 animagie_video_editor 插件裁剪视频并添加文本。

import 'package:flutter/material.dart';
import 'package:animagie_video_editor/animagie_video_editor.dart';
import 'package:permission_handler/permission_handler.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: VideoEditorScreen(),
    );
  }
}

class VideoEditorScreen extends StatefulWidget {
  [@override](/user/override)
  _VideoEditorScreenState createState() => _VideoEditorScreenState();
}

class _VideoEditorScreenState extends State<VideoEditorScreen> {
  final animagieVideoEditor = AnimagieVideoEditor();

  Future<void> editVideo() async {
    await requestPermissions();

    String inputPath = 'path/to/input/video.mp4';
    String outputPath = 'path/to/output/video.mp4';

    await animagieVideoEditor.cropVideo(
      inputPath: inputPath,
      outputPath: outputPath,
      startTime: Duration(seconds: 2),
      endTime: Duration(seconds: 10),
    );

    await animagieVideoEditor.addText(
      inputPath: outputPath,
      outputPath: outputPath,
      text: 'Hello, World!',
      position: TextPosition.center,
      textStyle: TextStyle(
        color: Colors.white,
        fontSize: 24,
      ),
    );

    print('Video editing completed');
  }

  Future<void> requestPermissions() async {
    var status = await Permission.storage.status;
    if (!status.isGranted) {
      await Permission.storage.request();
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Video Editor'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: editVideo,
          child: Text('Edit Video'),
        ),
      ),
    );
  }
}