You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
243 lines
9.9 KiB
243 lines
9.9 KiB
/*
|
|
* Copyright (c) 2019-2021 Taner Sener
|
|
*
|
|
* This file is part of FFmpegKit.
|
|
*
|
|
* FFmpegKit is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Lesser General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* FFmpegKit is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public License
|
|
* along with FFmpegKit. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
import 'package:ffmpeg_kit_flutter_platform_interface/ffmpeg_kit_flutter_platform_interface.dart';
|
|
import 'package:flutter/services.dart';
|
|
|
|
import 'ffmpeg_kit_config.dart';
|
|
import 'ffprobe_session.dart';
|
|
import 'ffprobe_session_complete_callback.dart';
|
|
import 'log_callback.dart';
|
|
import 'media_information_session.dart';
|
|
import 'media_information_session_complete_callback.dart';
|
|
import 'src/ffmpeg_kit_factory.dart';
|
|
|
|
/// Main class to run "FFprobe" commands.
|
|
class FFprobeKit {
|
|
static FFmpegKitPlatform _platform = FFmpegKitPlatform.instance;
|
|
|
|
/// Synchronously executes FFprobe command provided. Space character is used
|
|
/// to split command into arguments. You can use single or double quote
|
|
/// characters to specify arguments inside your command.
|
|
static Future<FFprobeSession> execute(String command,
|
|
[FFprobeSessionCompleteCallback? completeCallback = null,
|
|
LogCallback? logCallback = null]) async =>
|
|
FFprobeKit.executeWithArguments(FFmpegKitConfig.parseArguments(command),
|
|
completeCallback, logCallback);
|
|
|
|
/// Synchronously executes FFprobe with arguments provided.
|
|
static Future<FFprobeSession> executeWithArguments(
|
|
List<String> commandArguments,
|
|
[FFprobeSessionCompleteCallback? completeCallback = null,
|
|
LogCallback? logCallback = null]) async {
|
|
final session = await FFprobeSession.create(
|
|
commandArguments, completeCallback, logCallback, null);
|
|
|
|
await FFmpegKitConfig.ffprobeExecute(session);
|
|
|
|
return session;
|
|
}
|
|
|
|
/// Starts an asynchronous FFprobe execution for the given command. Space character is used to split the command
|
|
/// into arguments. You can use single or double quote characters to specify arguments inside your command.
|
|
///
|
|
/// Note that this method returns immediately and does not wait the execution to complete. You must use an
|
|
/// [FFprobeSessionCompleteCallback] if you want to be notified about the result.
|
|
static Future<FFprobeSession> executeAsync(String command,
|
|
[FFprobeSessionCompleteCallback? completeCallback = null,
|
|
LogCallback? logCallback = null]) async =>
|
|
FFprobeKit.executeWithArgumentsAsync(
|
|
FFmpegKitConfig.parseArguments(command),
|
|
completeCallback,
|
|
logCallback);
|
|
|
|
/// Starts an asynchronous FFprobe execution with arguments provided.
|
|
///
|
|
/// Note that this method returns immediately and does not wait the execution to complete. You must use an
|
|
/// [FFprobeSessionCompleteCallback] if you want to be notified about the result.
|
|
static Future<FFprobeSession> executeWithArgumentsAsync(
|
|
List<String> commandArguments,
|
|
[FFprobeSessionCompleteCallback? completeCallback = null,
|
|
LogCallback? logCallback = null]) async {
|
|
final session = await FFprobeSession.create(
|
|
commandArguments, completeCallback, logCallback, null);
|
|
|
|
await FFmpegKitConfig.asyncFFprobeExecute(session);
|
|
|
|
return session;
|
|
}
|
|
|
|
/// Extracts media information for the file specified with path.
|
|
static Future<MediaInformationSession> getMediaInformation(String path,
|
|
[MediaInformationSessionCompleteCallback? completeCallback = null,
|
|
LogCallback? logCallback = null,
|
|
int? waitTimeout = null]) async {
|
|
final commandArguments = [
|
|
"-v",
|
|
"error",
|
|
"-hide_banner",
|
|
"-print_format",
|
|
"json",
|
|
"-show_format",
|
|
"-show_streams",
|
|
"-show_chapters",
|
|
"-i",
|
|
path
|
|
];
|
|
return FFprobeKit.getMediaInformationFromCommandArguments(
|
|
commandArguments, completeCallback, logCallback, waitTimeout);
|
|
}
|
|
|
|
/// Extracts media information using the command provided. The command
|
|
/// passed to this method must generate the output in JSON format in order to
|
|
/// successfully extract media information from it.
|
|
static Future<MediaInformationSession> getMediaInformationFromCommand(
|
|
String command,
|
|
[MediaInformationSessionCompleteCallback? completeCallback = null,
|
|
LogCallback? logCallback = null,
|
|
int? waitTimeout = null]) async =>
|
|
FFprobeKit.getMediaInformationFromCommandArguments(
|
|
FFmpegKitConfig.parseArguments(command),
|
|
completeCallback,
|
|
logCallback,
|
|
waitTimeout);
|
|
|
|
/// Extracts media information using the command arguments provided. The
|
|
/// command passed to this method must generate the output in JSON format in
|
|
/// order to successfully extract media information from it.
|
|
static Future<MediaInformationSession>
|
|
getMediaInformationFromCommandArguments(List<String> commandArguments,
|
|
[MediaInformationSessionCompleteCallback? completeCallback = null,
|
|
LogCallback? logCallback = null,
|
|
int? waitTimeout = null]) async {
|
|
final session = await MediaInformationSession.create(
|
|
commandArguments, completeCallback, logCallback);
|
|
|
|
await FFmpegKitConfig.getMediaInformationExecute(session, waitTimeout);
|
|
|
|
return session;
|
|
}
|
|
|
|
/// Starts an asynchronous FFprobe execution to extract the media information for the specified file.
|
|
///
|
|
/// Note that this method returns immediately and does not wait the execution to complete. You must use an
|
|
/// [MediaInformationSessionCompleteCallback] if you want to be notified about the result.
|
|
static Future<MediaInformationSession> getMediaInformationAsync(String path,
|
|
[MediaInformationSessionCompleteCallback? completeCallback = null,
|
|
LogCallback? logCallback = null,
|
|
int? waitTimeout = null]) async {
|
|
final commandArguments = [
|
|
"-v",
|
|
"error",
|
|
"-hide_banner",
|
|
"-print_format",
|
|
"json",
|
|
"-show_format",
|
|
"-show_streams",
|
|
"-show_chapters",
|
|
"-i",
|
|
path
|
|
];
|
|
return FFprobeKit.getMediaInformationFromCommandArgumentsAsync(
|
|
commandArguments, completeCallback, logCallback, waitTimeout);
|
|
}
|
|
|
|
/// Starts an asynchronous FFprobe execution to extract media information using a command. The command passed to
|
|
/// this method must generate the output in JSON format in order to successfully extract media information from it.
|
|
///
|
|
/// Note that this method returns immediately and does not wait the execution to complete. You must use an
|
|
/// [MediaInformationSessionCompleteCallback] if you want to be notified about the result.
|
|
static Future<MediaInformationSession> getMediaInformationFromCommandAsync(
|
|
String command,
|
|
[MediaInformationSessionCompleteCallback? completeCallback = null,
|
|
LogCallback? logCallback = null,
|
|
int? waitTimeout = null]) async =>
|
|
FFprobeKit.getMediaInformationFromCommandArgumentsAsync(
|
|
FFmpegKitConfig.parseArguments(command),
|
|
completeCallback,
|
|
logCallback,
|
|
waitTimeout);
|
|
|
|
/// Starts an asynchronous FFprobe execution to extract media information
|
|
/// using command arguments. The command passed to this method must generate
|
|
/// the output in JSON format in order to successfully extract media
|
|
/// information from it.
|
|
///
|
|
/// Note that this method returns immediately and does not wait the execution
|
|
/// to complete. You must use an [MediaInformationSessionCompleteCallback] if you want to be
|
|
/// notified about the result.
|
|
static Future<MediaInformationSession>
|
|
getMediaInformationFromCommandArgumentsAsync(
|
|
List<String> commandArguments,
|
|
[MediaInformationSessionCompleteCallback? completeCallback = null,
|
|
LogCallback? logCallback = null,
|
|
int? waitTimeout = null]) async {
|
|
final session = await MediaInformationSession.create(
|
|
commandArguments, completeCallback, logCallback);
|
|
|
|
await FFmpegKitConfig.asyncGetMediaInformationExecute(session, waitTimeout);
|
|
|
|
return session;
|
|
}
|
|
|
|
/// Lists all FFprobe sessions in the session history.
|
|
static Future<List<FFprobeSession>> listFFprobeSessions() async {
|
|
try {
|
|
await FFmpegKitConfig.init();
|
|
return _platform.ffprobeKitListFFprobeSessions().then((sessions) {
|
|
if (sessions == null) {
|
|
return List.empty();
|
|
} else {
|
|
return sessions
|
|
.map((dynamic sessionObject) => FFmpegKitFactory.mapToSession(
|
|
sessionObject as Map<dynamic, dynamic>))
|
|
.map((session) => session as FFprobeSession)
|
|
.toList();
|
|
}
|
|
});
|
|
} on PlatformException catch (e, stack) {
|
|
print("Plugin listFFprobeSessions error: ${e.message}");
|
|
return Future.error("listFFprobeSessions failed.", stack);
|
|
}
|
|
}
|
|
|
|
/// Lists all MediaInformation sessions in the session history.
|
|
static Future<List<MediaInformationSession>>
|
|
listMediaInformationSessions() async {
|
|
try {
|
|
await FFmpegKitConfig.init();
|
|
return _platform
|
|
.ffprobeKitListMediaInformationSessions()
|
|
.then((sessions) {
|
|
if (sessions == null) {
|
|
return List.empty();
|
|
} else {
|
|
return sessions
|
|
.map((dynamic sessionObject) => FFmpegKitFactory.mapToSession(
|
|
sessionObject as Map<dynamic, dynamic>))
|
|
.map((session) => session as MediaInformationSession)
|
|
.toList();
|
|
}
|
|
});
|
|
} on PlatformException catch (e, stack) {
|
|
print("Plugin listMediaInformationSessions error: ${e.message}");
|
|
return Future.error("listMediaInformationSessions failed.", stack);
|
|
}
|
|
}
|
|
}
|
|
|