ffmpeg cli wrapper

適用於 Java 的 FFmpeg CLI 包裝器

作者：安德魯‧布蘭普頓 (bramp.net) (c) 2013-2024

用於從 Java 運行 FFmpeg 的流暢介面。

GitHub | API文件

安裝

我們目前支援 Java 8 及更高版本。使用Maven安裝依賴。

< dependency >
  < groupId >net.bramp.ffmpeg</ groupId >
  < artifactId >ffmpeg</ artifactId >
  < version >0.8.0</ version >
</ dependency >

用法

視訊編碼

代碼：

 FFmpeg ffmpeg = new FFmpeg ( "/path/to/ffmpeg" );
FFprobe ffprobe = new FFprobe ( "/path/to/ffprobe" );

FFmpegBuilder builder = new FFmpegBuilder ()

  . setInput ( "input.mp4" )     // Filename, or a FFmpegProbeResult
  . done ()
  . overrideOutputFiles ( true ) // Override the output if it exists

  . addOutput ( "output.mp4" )   // Filename for the destination
    . setFormat ( "mp4" )        // Format is inferred from filename, or can be set
    . setTargetSize ( 250_000 )  // Aim for a 250KB file

    . disableSubtitle ()       // No subtiles

    . setAudioChannels ( 1 )         // Mono audio
    . setAudioCodec ( "aac" )        // using the aac codec
    . setAudioSampleRate ( 48_000 )  // at 48KHz
    . setAudioBitRate ( 32768 )      // at 32 kbit/s

    . setVideoCodec ( "libx264" )     // Video using x264
    . setVideoFrameRate ( 24 , 1 )     // at 24 frames per second
    . setVideoResolution ( 640 , 480 ) // at 640x480 resolution

    . setStrict ( FFmpegBuilder . Strict . EXPERIMENTAL ) // Allow FFmpeg to use experimental specs
  . done ();

FFmpegExecutor executor = new FFmpegExecutor ( ffmpeg , ffprobe );

// Run a one-pass encode
executor . createJob ( builder ). run ();

// Or run a two-pass encode (which is better quality at the cost of being slower)
executor . createTwoPassJob ( builder ). run ();

獲取媒體訊息

代碼：

 FFprobe ffprobe = new FFprobe ( "/path/to/ffprobe" );
FFmpegProbeResult probeResult = ffprobe . probe ( "input.mp4" );

FFmpegFormat format = probeResult . getFormat ();
System . out . format ( "%nFile: '%s' ; Format: '%s' ; Duration: %.3fs" , 
 format . filename ,
 format . format_long_name ,
 format . duration
);

FFmpegStream stream = probeResult . getStreams (). get ( 0 );
System . out . format ( "%nCodec: '%s' ; Width: %dpx ; Height: %dpx" ,
 stream . codec_long_name ,
 stream . width ,
 stream . height
);

編碼時取得進度

 FFmpegExecutor executor = new FFmpegExecutor ( ffmpeg , ffprobe );

FFmpegProbeResult in = ffprobe . probe ( "input.flv" );

FFmpegBuilder builder = new FFmpegBuilder ()
 . setInput ( in ) // Or filename
 . done ()
 . addOutput ( "output.mp4" )
 . done ();

FFmpegJob job = executor . createJob ( builder , new ProgressListener () {

 // Using the FFmpegProbeResult determine the duration of the input
 final double duration_ns = in . getFormat (). duration * TimeUnit . SECONDS . toNanos ( 1 );

 @ Override
 public void progress ( Progress progress ) {
  double percentage = progress . out_time_ns / duration_ns ;

  // Print out interesting information about the progress
  System . out . println ( String . format (
   "[%.0f%%] status:%s frame:%d time:%s ms fps:%.0f speed:%.2fx" ,
   percentage * 100 ,
   progress . status ,
   progress . frame ,
   FFmpegUtils . toTimecode ( progress . out_time_ns , TimeUnit . NANOSECONDS ),
   progress . fps . doubleValue (),
   progress . speed
  ));
 }
});

job . run ();

建置和發布

如果您想進行更改，那麼建置和發布很簡單：

 # To build
mvn

# To test
mvn test

# To release (pushing jar to maven central)
# (don't forget to set up your ~/.m2/settings.xml)
mvn release:prepare
mvn release:perform

# To publish javadoc
git checkout ffmpeg-0.x
mvn clean javadoc:aggregate scm-publish:publish-scm

顛簸部門

 # Update Maven Plugins
mvn versions:display-plugin-updates

# Library Dependencies
mvn versions:display-dependency-updates 

在 Ubuntu 上安裝 FFmpeg

我們只支援原始的 FFmpeg，不支援 libav 版本。 Ubuntu 12.04 之前以及 15.04 及更高版本中提供了原始 FFmpeg。如果您必須在具有 libav 的版本上執行，您可以從 PPA 或使用靜態建置安裝 FFmpeg。更多資訊請點擊此處

介入

我們歡迎貢獻。請檢查問題追蹤器。如果您看到想要處理的內容，請對該問題發表評論，或只是發送拉取請求。想做別的事情，那就打開一個問題，我們就可以討論！我們感謝文件改進、程式碼清理或新功能。請注意，所有工作都是在志工的基礎上完成的，因此我們的回應可能會很慢。

許可證（簡化 BSD 許可證）

 Copyright (c) 2013-2024, Andrew Brampton
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this
  list of conditions and the following disclaimer.

* Redistributions in binary form must reproduce the above copyright notice,
  this list of conditions and the following disclaimer in the documentation
  and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.