goffm

README

Go与FFmpeg视频操作库集成使用指南

1. 介绍

FFmpeg视频操作库

FFmpeg是一个功能强大的开源多媒体框架，能够解码、编码、转码、mux、demux、流处理、过滤和播放几乎所有已知的音频和视频格式。其特点包括高度的模块化和灵活性，使得它成为多媒体处理领域的基石。FFmpeg支持多种操作系统，并且可以通过命令行或作为库嵌入到其他应用程序中。

在Go语言中，虽然FFmpeg本身是用C语言编写的，但我们可以通过cgo（Go语言调用C代码的能力）来访问FFmpeg的功能，实现对视频和音频的丰富操作，如格式转换、剪辑、拼接、添加滤镜等。

应用场景

• 视频编辑与处理：剪辑、拼接、转码等。
• 实时流媒体处理：捕获、转码、推送流等。
• 视频分析：帧提取、关键帧检测、内容识别等。
• 跨平台视频格式转换。

2. 技术架构

内部原理

FFmpeg内部采用模块化设计，包括解码器（libavcodec）、复用器/解复用器（libavformat）、过滤器（libavfilter）、编码器（libavcodec的一部分）、视频处理（libswscale）、音频重采样（libswresample）等关键组件。每个组件负责处理数据流的不同部分，并通过FFmpeg的API相互协作。

数据流处理流程

1. 解复用（Demuxing）：从文件中读取数据，分离成音频、视频等流。
2. 解码（Decoding）：将压缩的音视频数据转换为原始数据（如YUV图像帧和PCM音频样本）。
3. 处理（Filtering/Processing）：对解码后的数据进行处理，如缩放、裁剪、添加滤镜等。
4. 编码（Encoding）：将处理后的数据重新编码为压缩格式。
5. 复用（Muxing）：将编码后的音视频流组合成一个文件。

Go语言集成

在Go中，我们主要使用cgo来调用FFmpeg的命令。

3. 安装教程

环境准备

1. 安装FFmpeg：

   • 在Linux上，通常可以通过包管理器安装（如sudo apt-get install ffmpeg）。
   • 在Windows或Mac上，可以从FFmpeg官网下载预编译的二进制文件。
   • 配置环境变量，变量名FFMPEG_PATH,若未配置，会自动扫描查找所有环境变量

2. 设置Go环境：

   • 确保Go语言环境已安装并配置好GOPATH和GOROOT。

Go代码集成

1. 创建Go包：

   • 创建一个新的Go包，并在其中包含C接口文件（例如ffmpeg.h）和C源码文件（如果需要）。

2. 编写cgo代码：

   • 在Go文件中使用import "C"语句引入C库。
   • 编写Go函数，通过cgo调用FFmpeg的C API。

3. 编译和测试：

   • 使用go build编译Go代码，并确保cgo能正确找到FFmpeg的库文件。
   • 运行测试，验证功能是否按预期工作。

4. 安装库：

go get -u gitee.com/bobo-rs/goffm

4. 使用说明

常用功能

• 视频解码：读取视频文件，解码成帧。
• 视频编码：将视频帧编码为特定格式。
• 格式转换：将视频从一个格式转换为另一个格式。
• 视频处理：如缩放、裁剪、添加水印等。
• 视频信息：视频内容读取

参数设置

FFmpeg的参数设置通常在C API调用时通过结构体和函数参数完成。在Go中，你需要将相应的C结构体映射为Go的结构体，并适当处理内存分配和释放。

• 文件目录

├─example-------示例代码目录
│  └─exp
├─ffmpeg--------视频处理（转换、压缩、剪辑、合并等）
├─ffprobe-------视频详情（视频流、音频流、尺寸、大小、高宽度等）
└─utils---------工具函数类

错误处理

FFmpeg的C API通常通过返回值和全局错误码来报告错误。在Go中，你需要检查这些错误码，并相应地处理错误（如通过C.av_strerror()获取错误描述）。

示例代码

• 转换视频格式：以下是一个简化的示例，展示了如何使用goffmpeg执行FFmpeg命令视频格式：

package main

import (
   "context"
   "fmt"
   "gitee.com/bobo-rs/goffm/ffmpeg"
)

func main() {
	// 批量转换
	fmt.Println(ffmpeg.New().BatchConvertVideos(context.Background(), 3, &ffmpeg.ConvertVideo{
		Src: `xxxx.mp4`,
		OutExt: `webm`,
    }, &ffmpeg.ConvertVideo{
       Src: `xxxx.mp4`,
       OutExt: `avi`,
    }, &ffmpeg.ConvertVideo{
       Src: `xxxx.mp4`,
       OutExt: `m3u8`,
    }))

   // 单个视频转换
   fmt.Println(ffmpeg.New().ConvertVideo(`xxxx.mp4`, `m3u8`))
}

可使用功能：视频转换、视频压缩、合并视频、剪辑视频（批量剪辑、指定时间剪辑、按剪辑格式平均剪辑等） 注意：上面的代码是一个简化的示例，用于说明如何通过cgo调用FFmpeg的API。在实际应用中，你需要添加完整的错误处理、结构体映射和适当的内存管理。此外，FFmpeg的API在不断更新，请参考最新的FFmpeg文档进行开发。