FFmpegCommand：轻量级FFmpeg命令工具库

FFmpegCommand：轻量级FFmpeg命令工具库

FFmpegCommandFFmpegCommand适用于Android的FFmpeg命令库，实现了对音视频相关的处理，能够快速的处理音视频，大概功能包括：音视频剪切，音视频转码，音视频解码原始数据，音视频编码，视频转图片或gif，视频添加水印，多画面拼接，音频混音，视频亮度和对比度，音频淡入和淡出效果等项目地址:https://gitcode.com/gh_mirrors/ff/FFmpegCommand

项目介绍

FFmpegCommand 是一个基于FFmpeg的核心库，专为简化Android应用程序中的音视频处理而设计。它整合了诸如lame、libx264、fdk-aac和libopencore-amr等主流的音频和视频处理组件。此库允许开发者通过简单的API调用来执行常见的FFmpeg操作，无需关心复杂的交叉编译过程。

主要特性

• 简化的FFmpeg命令接口
• 支持同步和异步执行命令
• 错误日志提示
• 获取媒体信息
• 获取支持的封装和解码格式
• 易于集成和混淆配置

项目快速启动

首先确保你的Android项目满足minSdkVersion >=21的要求。接下来，在你的build.gradle文件中添加依赖：

dependencies {
    implementation 'com.coder_ffmpeg:ffmpegcommand:<latest_version>'
}

在应用中初始化FFmpegCommand并执行基本的转换任务：

import com.coder_ffmpeg.FFmpegCommand
import java.io.File

val sourceVideoPath = "path/to/source/video.mp4"
val outputFilePath = "${externalCacheDir?.absolutePath}/output.mp4"

// 设置调试模式
FFmpegCommand.setDebug(true)

// 创建命令参数
val command = CommandParams()
.append("-i")
.append(sourceVideoPath)
.append("-c:v")
.append("copy") 
.append("-c:a")
.append("aac")
.append(outputFilePath)

// 同步执行命令
FFmpegCommand.runCmd(command)

// 异步执行命令
GlobalScope.launch(Dispatchers.IO) {
    FFmpegCommand.runCmd(command, object : IFFmpegCallBack {
        override fun onStart() {}
        override fun onComplete() {}
        override fun onCancel() {}
        override fun onError(error: String?) {}
        override fun onProgress(progress: Float) {}
    })
}

注意： 你需要适当地捕获并处理onError回调中的异常。

应用案例和最佳实践

视频转码

以下是一个将视频流从一种编码转换为另一种编码的例子：

val sourcePath = "path/to/source.mp4"
val outputPath = "path/to/output.mp4"
val cmd = CommandParams()
    .append("-i")
    .append(sourcePath)
    .append("-c:v")
    .append("libx264") // 设定编码器
    .append("-preset")
    .append("medium") // 设定预设值
    .append("-crf")
    .append("22") // 质量因子
    .append("-c:a")
    .append("aac") // 音频编码
    .append(outputPath)
FFmpegCommand.runCmd(cmd)

获取媒体信息

获取视频的宽度、高度和比特率：

val mediaInfo = FFmpegCommand.getMediaInfo("path/to/media.mp4", MediaAttribute.INFO)
Log.d("MediaInfo", "Width: ${mediaInfo.width}, Height: ${mediaInfo.height}, Bitrate: ${mediaInfo.bitRate}")

典型生态项目

尽管FFmpegCommand是一个独立库，但它的核心——FFmpeg——在多媒体处理领域有着广泛的应用。以下是一些使用FFmpeg的知名开源项目：

• VLC - 多平台的免费媒体播放器
• OpenCV - 开源计算机视觉库，可用于视频分析和图像处理
• HandBrake - 视频转码工具
• OmniPlayer - iOS上的全能媒体播放器

通过集成FFmpegCommand，你可以轻松地在你的Android应用中实现类似的功能，为用户提供强大的多媒体处理能力。

---

许可证 该项目遵循Apache License Version 2.0，详细信息请查阅项目根目录下的LICENSE文件。

FFmpegCommandFFmpegCommand适用于Android的FFmpeg命令库，实现了对音视频相关的处理，能够快速的处理音视频，大概功能包括：音视频剪切，音视频转码，音视频解码原始数据，音视频编码，视频转图片或gif，视频添加水印，多画面拼接，音频混音，视频亮度和对比度，音频淡入和淡出效果等项目地址:https://gitcode.com/gh_mirrors/ff/FFmpegCommand