|
|
@@ -89,6 +89,8 @@ to enable other installed packages using the following steps.
|
|
|
### 3. Using
|
|
|
|
|
|
1. Execute commands.
|
|
|
+
|
|
|
+ - Use execute() method with a single command line
|
|
|
```
|
|
|
import 'package:flutter_ffmpeg/flutter_ffmpeg.dart';
|
|
|
|
|
|
@@ -96,31 +98,76 @@ to enable other installed packages using the following steps.
|
|
|
|
|
|
_flutterFFmpeg.execute("-i file1.mp4 -c:v mpeg4 file2.mp4").then((rc) => print("FFmpeg process exited with rc $rc"));
|
|
|
```
|
|
|
+
|
|
|
+ - Use executeWithArguments() method with an array of arguments
|
|
|
|
|
|
-2. Check execution output.
|
|
|
- ```
|
|
|
- _flutterFFmpeg.getLastReturnCode().then((rc) => print("Last rc: $rc"));
|
|
|
- _flutterFFmpeg.getLastCommandOutput().then((output) => print("Last command output: $output"));
|
|
|
```
|
|
|
+ import 'package:flutter_ffmpeg/flutter_ffmpeg.dart';
|
|
|
|
|
|
-3. Stop an ongoing operation.
|
|
|
- ```
|
|
|
- _flutterFFmpeg.cancel();
|
|
|
+ final FlutterFFmpeg _flutterFFmpeg = new FlutterFFmpeg();
|
|
|
+
|
|
|
+ var arguments = ["-i", "file1.mp4", "-c:v", "mpeg4", "file2.mp4"];
|
|
|
+ _flutterFFmpeg.executeWithArguments(arguments).then((rc) => print("FFmpeg process exited with rc $rc"));
|
|
|
```
|
|
|
|
|
|
-4. Get media information for a file.
|
|
|
+2. Check execution output. Zero represents successful execution, non-zero values represent failure.
|
|
|
```
|
|
|
- _flutterFFmpeg.getMediaInformation('<file path or uri>').then((info) => print(info));
|
|
|
+ _flutterFFmpeg.getLastReturnCode().then((rc) => print("Last rc: $rc"));
|
|
|
+
|
|
|
+ _flutterFFmpeg.getLastCommandOutput().then((output) => print("Last command output: $output"));
|
|
|
```
|
|
|
|
|
|
-5. List enabled external libraries.
|
|
|
+3. Stop an ongoing operation. Note that this function does not wait for termination to complete and returns immediately.
|
|
|
```
|
|
|
- _flutterFFmpeg.getExternalLibraries().then((packageList) {
|
|
|
- packageList.forEach((value) => print("External library: $value"));
|
|
|
- });
|
|
|
+ _flutterFFmpeg.cancel();
|
|
|
```
|
|
|
|
|
|
-6. Enable log callback.
|
|
|
+4. Get media information for a file.
|
|
|
+ - Print all fields
|
|
|
+ ```
|
|
|
+ _flutterFFmpeg.getMediaInformation("<file path or uri>").then((info) => print(info));
|
|
|
+ ```
|
|
|
+ - Print selected fields
|
|
|
+ ```
|
|
|
+ _flutterFFmpeg.getMediaInformation("<file path or uri>").then((info) {
|
|
|
+ print("Media Information");
|
|
|
+
|
|
|
+ print("Path: ${info['path']}");
|
|
|
+ print("Format: ${info['format']}");
|
|
|
+ print("Duration: ${info['duration']}");
|
|
|
+ print("Start time: ${info['startTime']}");
|
|
|
+ print("Bitrate: ${info['bitrate']}");
|
|
|
+
|
|
|
+ if (info['streams'] != null) {
|
|
|
+ final streamsInfoArray = info['streams'];
|
|
|
+
|
|
|
+ if (streamsInfoArray.length > 0) {
|
|
|
+ for (var streamsInfo in streamsInfoArray) {
|
|
|
+ print("Stream id: ${streamsInfo['index']}");
|
|
|
+ print("Stream type: ${streamsInfo['type']}");
|
|
|
+ print("Stream codec: ${streamsInfo['codec']}");
|
|
|
+ print("Stream full codec: ${streamsInfo['fullCodec']}");
|
|
|
+ print("Stream format: ${streamsInfo['format']}");
|
|
|
+ print("Stream full format: ${streamsInfo['fullFormat']}");
|
|
|
+ print("Stream width: ${streamsInfo['width']}");
|
|
|
+ print("Stream height: ${streamsInfo['height']}");
|
|
|
+ print("Stream bitrate: ${streamsInfo['bitrate']}");
|
|
|
+ print("Stream sample rate: ${streamsInfo['sampleRate']}");
|
|
|
+ print("Stream sample format: ${streamsInfo['sampleFormat']}");
|
|
|
+ print("Stream channel layout: ${streamsInfo['channelLayout']}");
|
|
|
+ print("Stream sar: ${streamsInfo['sampleAspectRatio']}");
|
|
|
+ print("Stream dar: ${streamsInfo['displayAspectRatio']}");
|
|
|
+ print("Stream average frame rate: ${streamsInfo['averageFrameRate']}");
|
|
|
+ print("Stream real frame rate: ${streamsInfo['realFrameRate']}");
|
|
|
+ print("Stream time base: ${streamsInfo['timeBase']}");
|
|
|
+ print("Stream codec time base: ${streamsInfo['codecTimeBase']}");
|
|
|
+ }
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ ```
|
|
|
+
|
|
|
+5. Enable log callback and redirect all `FFmpeg` logs to a console/file/widget.
|
|
|
```
|
|
|
void logCallback(int level, String message) {
|
|
|
print(message);
|
|
|
@@ -129,7 +176,7 @@ to enable other installed packages using the following steps.
|
|
|
_flutterFFmpeg.enableLogCallback(this.logCallback);
|
|
|
```
|
|
|
|
|
|
-7. Enable statistics callback.
|
|
|
+6. Enable statistics callback and follow the progress of an ongoing operation.
|
|
|
```
|
|
|
void statisticsCallback(int time, int size, double bitrate, double speed, int videoFrameNumber, double videoQuality, double videoFps) {
|
|
|
print("Statistics: time: $time, size: $size, bitrate: $bitrate, speed: $speed, videoFrameNumber: $videoFrameNumber, videoQuality: $videoQuality, videoFps: $videoFps");
|
|
|
@@ -138,21 +185,48 @@ to enable other installed packages using the following steps.
|
|
|
_flutterFFmpeg.enableStatisticsCallback(this.statisticsCallback);
|
|
|
```
|
|
|
|
|
|
-8. Get last received statistics.
|
|
|
+7. Poll statistics without implementing statistics callback.
|
|
|
```
|
|
|
_flutterFFmpeg.getLastReceivedStatistics().then((stats) => print(stats));
|
|
|
```
|
|
|
|
|
|
+8. Reset statistics before starting a new operation.
|
|
|
+ ```
|
|
|
+ _flutterFFmpeg.resetStatistics();
|
|
|
+ ```
|
|
|
+
|
|
|
9. Set log level.
|
|
|
```
|
|
|
_flutterFFmpeg.setLogLevel(LogLevel.AV_LOG_WARNING);
|
|
|
```
|
|
|
|
|
|
-10. Register custom fonts directory.
|
|
|
+10. Register your own fonts by specifying a custom fonts directory, so they are available to use in `FFmpeg` filters.
|
|
|
```
|
|
|
_flutterFFmpeg.setFontDirectory("<folder with fonts>");
|
|
|
```
|
|
|
|
|
|
+11. Use your own `fontconfig` configuration.
|
|
|
+ ```
|
|
|
+ _flutterFFmpeg.setFontconfigConfigurationPath("<fontconfig configuration directory>");
|
|
|
+ ```
|
|
|
+
|
|
|
+12. Disable log functionality of the library. Logs will not be printed to console and log callback will be disabled.
|
|
|
+ ```
|
|
|
+ _flutterFFmpeg.disableLogs();
|
|
|
+ ```
|
|
|
+
|
|
|
+13. Disable statistics functionality of the library. Statistics callback will be disabled but the last received statistics data will be still available.
|
|
|
+ ```
|
|
|
+ _flutterFFmpeg.disableStatistics();
|
|
|
+ ```
|
|
|
+
|
|
|
+14. List enabled external libraries.
|
|
|
+ ```
|
|
|
+ _flutterFFmpeg.getExternalLibraries().then((packageList) {
|
|
|
+ packageList.forEach((value) => print("External library: $value"));
|
|
|
+ });
|
|
|
+ ```
|
|
|
+
|
|
|
### 4. Versions
|
|
|
|
|
|
#### 4.1 Releases
|
Taner Sener