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.
241 lines
11 KiB
241 lines
11 KiB
/*
|
|
* Copyright (c) 2020-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/>.
|
|
*/
|
|
|
|
#ifndef FFPROBE_KIT_H
|
|
#define FFPROBE_KIT_H
|
|
|
|
#import <string.h>
|
|
#import <stdlib.h>
|
|
#import <Foundation/Foundation.h>
|
|
#import "FFprobeSession.h"
|
|
#import "MediaInformationJsonParser.h"
|
|
|
|
/**
|
|
* <p>Main class to run <code>FFprobe</code> commands. Supports executing commands both
|
|
* synchronously and asynchronously.
|
|
* <pre>
|
|
* FFprobeSession *session = [FFprobeKit execute:@"-hide_banner -v error -show_entries format=size -of default=noprint_wrappers=1 file1.mp4"];
|
|
*
|
|
* FFprobeSession *asyncSession = [FFprobeKit executeAsync:@"-hide_banner -v error -show_entries format=size -of default=noprint_wrappers=1 file1.mp4" withExecuteDelegate:executeDelegate];
|
|
* </pre>
|
|
* <p>Provides overloaded <code>execute</code> methods to define session specific delegates.
|
|
* <pre>
|
|
* FFprobeSession *session = [FFprobeKit executeAsync:@"-hide_banner -v error -show_entries format=size -of default=noprint_wrappers=1 file1.mp4" withExecuteDelegate:executeDelegate withLogDelegate:logDelegate];
|
|
* </pre>
|
|
* <p>It can extract media information for a file or a url, using getMediaInformation method.
|
|
* <pre>
|
|
* MediaInformationSession *session = [FFprobeKit getMediaInformation:@"file1.mp4"];
|
|
* </pre>
|
|
*/
|
|
@interface FFprobeKit : NSObject
|
|
|
|
/**
|
|
* <p>Synchronously executes FFprobe with arguments provided.
|
|
*
|
|
* @param arguments FFprobe command options/arguments as string array
|
|
* @return FFprobe session created for this execution
|
|
*/
|
|
+ (FFprobeSession*)executeWithArguments:(NSArray*)arguments;
|
|
|
|
/**
|
|
* <p>Asynchronously executes FFprobe with arguments provided.
|
|
*
|
|
* @param arguments FFprobe command options/arguments as string array
|
|
* @param executeDelegate delegate that will be called when the execution is completed
|
|
* @return FFprobe session created for this execution
|
|
*/
|
|
+ (FFprobeSession*)executeWithArgumentsAsync:(NSArray*)arguments withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate;
|
|
|
|
/**
|
|
* <p>Asynchronously executes FFprobe with arguments provided.
|
|
*
|
|
* @param arguments FFprobe command options/arguments as string array
|
|
* @param executeDelegate delegate that will be notified when execution is completed
|
|
* @param logDelegate delegate that will receive logs
|
|
* @return FFprobe session created for this execution
|
|
*/
|
|
+ (FFprobeSession*)executeWithArgumentsAsync:(NSArray*)arguments withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate withLogDelegate:(id<LogDelegate>)logDelegate;
|
|
|
|
/**
|
|
* <p>Asynchronously executes FFprobe with arguments provided.
|
|
*
|
|
* @param arguments FFprobe command options/arguments as string array
|
|
* @param executeDelegate delegate that will be called when the execution is completed
|
|
* @param queue dispatch queue that will be used to run this asynchronous operation
|
|
* @return FFprobe session created for this execution
|
|
*/
|
|
+ (FFprobeSession*)executeWithArgumentsAsync:(NSArray*)arguments withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate onDispatchQueue:(dispatch_queue_t)queue;
|
|
|
|
/**
|
|
* <p>Asynchronously executes FFprobe with arguments provided.
|
|
*
|
|
* @param arguments FFprobe command options/arguments as string array
|
|
* @param executeDelegate delegate that will be notified when execution is completed
|
|
* @param logDelegate delegate that will receive logs
|
|
* @param queue dispatch queue that will be used to run this asynchronous operation
|
|
* @return FFprobe session created for this execution
|
|
*/
|
|
+ (FFprobeSession*)executeWithArgumentsAsync:(NSArray*)arguments withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate withLogDelegate:(id<LogDelegate>)logDelegate onDispatchQueue:(dispatch_queue_t)queue;
|
|
|
|
/**
|
|
* <p>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.
|
|
*
|
|
* @param command FFprobe command
|
|
* @return FFprobe session created for this execution
|
|
*/
|
|
+ (FFprobeSession*)execute:(NSString*)command;
|
|
|
|
/**
|
|
* <p>Asynchronously 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.
|
|
*
|
|
* @param command FFprobe command
|
|
* @param executeDelegate delegate that will be called when the execution is completed
|
|
* @return FFprobe session created for this execution
|
|
*/
|
|
+ (FFprobeSession*)executeAsync:(NSString*)command withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate;
|
|
|
|
/**
|
|
* <p>Asynchronously 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.
|
|
*
|
|
* @param command FFprobe command
|
|
* @param executeDelegate delegate that will be notified when execution is completed
|
|
* @param logDelegate delegate that will receive logs
|
|
* @return FFprobe session created for this execution
|
|
*/
|
|
+ (FFprobeSession*)executeAsync:(NSString*)command withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate withLogDelegate:(id<LogDelegate>)logDelegate;
|
|
|
|
/**
|
|
* <p>Asynchronously 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.
|
|
*
|
|
* @param command FFprobe command
|
|
* @param executeDelegate delegate that will be called when the execution is completed
|
|
* @param queue dispatch queue that will be used to run this asynchronous operation
|
|
* @return FFprobe session created for this execution
|
|
*/
|
|
+ (FFprobeSession*)executeAsync:(NSString*)command withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate onDispatchQueue:(dispatch_queue_t)queue;
|
|
|
|
/**
|
|
* <p>Asynchronously 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.
|
|
*
|
|
* @param command FFprobe command
|
|
* @param executeDelegate delegate that will be called when the execution is completed
|
|
* @param logDelegate delegate that will receive logs
|
|
* @param queue dispatch queue that will be used to run this asynchronous operation
|
|
* @return FFprobe session created for this execution
|
|
*/
|
|
+ (FFprobeSession*)executeAsync:(NSString*)command withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate withLogDelegate:(id<LogDelegate>)logDelegate onDispatchQueue:(dispatch_queue_t)queue;
|
|
|
|
/**
|
|
* <p>Extracts media information for the file specified with path.
|
|
*
|
|
* @param path path or uri of a media file
|
|
* @return media information session created for this execution
|
|
*/
|
|
+ (MediaInformationSession*)getMediaInformation:(NSString*)path;
|
|
|
|
/**
|
|
* <p>Extracts media information for the file specified with path.
|
|
*
|
|
* @param path path or uri of a media file
|
|
* @param waitTimeout max time to wait until media information is transmitted
|
|
* @return media information session created for this execution
|
|
*/
|
|
+ (MediaInformationSession*)getMediaInformation:(NSString*)path withTimeout:(int)waitTimeout;
|
|
|
|
/**
|
|
* <p>Extracts media information for the file specified with path asynchronously.
|
|
*
|
|
* @param path path or uri of a media file
|
|
* @param executeDelegate delegate that will be called when the execution is completed
|
|
* @return media information session created for this execution
|
|
*/
|
|
+ (MediaInformationSession*)getMediaInformationAsync:(NSString*)path withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate;
|
|
|
|
/**
|
|
* <p>Extracts media information for the file specified with path asynchronously.
|
|
*
|
|
* @param path path or uri of a media file
|
|
* @param executeDelegate delegate that will be notified when execution is completed
|
|
* @param logDelegate delegate that will receive logs
|
|
* @param waitTimeout max time to wait until media information is transmitted
|
|
* @return media information session created for this execution
|
|
*/
|
|
+ (MediaInformationSession*)getMediaInformationAsync:(NSString*)path withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate withLogDelegate:(id<LogDelegate>)logDelegate withTimeout:(int)waitTimeout;
|
|
|
|
/**
|
|
* <p>Extracts media information for the file specified with path asynchronously.
|
|
*
|
|
* @param path path or uri of a media file
|
|
* @param executeDelegate delegate that will be called when the execution is completed
|
|
* @param queue dispatch queue that will be used to run this asynchronous operation
|
|
* @return media information session created for this execution
|
|
*/
|
|
+ (MediaInformationSession*)getMediaInformationAsync:(NSString*)path withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate onDispatchQueue:(dispatch_queue_t)queue;
|
|
|
|
/**
|
|
* <p>Extracts media information for the file specified with path asynchronously.
|
|
*
|
|
* @param path path or uri of a media file
|
|
* @param executeDelegate delegate that will be notified when execution is completed
|
|
* @param logDelegate delegate that will receive logs
|
|
* @param queue dispatch queue that will be used to run this asynchronous operation
|
|
* @param waitTimeout max time to wait until media information is transmitted
|
|
* @return media information session created for this execution
|
|
*/
|
|
+ (MediaInformationSession*)getMediaInformationAsync:(NSString*)path withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate withLogDelegate:(id<LogDelegate>)logDelegate onDispatchQueue:(dispatch_queue_t)queue withTimeout:(int)waitTimeout;
|
|
|
|
/**
|
|
* <p>Extracts media information using the command provided asynchronously.
|
|
*
|
|
* @param command FFprobe command that prints media information for a file in JSON format
|
|
* @return media information session created for this execution
|
|
*/
|
|
+ (MediaInformationSession*)getMediaInformationFromCommand:(NSString*)command;
|
|
|
|
/**
|
|
* <p>Extracts media information using the command provided asynchronously.
|
|
*
|
|
* @param command FFprobe command that prints media information for a file in JSON format
|
|
* @param executeDelegate delegate that will be notified when execution is completed
|
|
* @param logDelegate delegate that will receive logs
|
|
* @param waitTimeout max time to wait until media information is transmitted
|
|
* @return media information session created for this execution
|
|
*/
|
|
+ (MediaInformationSession*)getMediaInformationFromCommandAsync:(NSString*)command withExecuteDelegate:(id<ExecuteDelegate>)executeDelegate withLogDelegate:(id<LogDelegate>)logDelegate onDispatchQueue:(dispatch_queue_t)queue withTimeout:(int)waitTimeout;
|
|
|
|
/**
|
|
* <p>Lists all FFprobe sessions in the session history.
|
|
*
|
|
* @return all FFprobe sessions in the session history
|
|
*/
|
|
+ (NSArray*)listSessions;
|
|
|
|
@end
|
|
|
|
#endif // FFPROBE_KIT_H
|
|
|