# 视频处理库

**Repository Path**: bobo-rs/goffmpeg

## Basic Information

- **Project Name**: 视频处理库
- **Description**: 视频处理库，裁剪、压缩、转换、合并、解码等
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-08-26
- **Last Updated**: 2024-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## 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. **安装库**：
```bash
go get -u gitee.com/bobo-rs/goffmpeg
```

## 4. 使用说明

### 常用功能

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

### 参数设置

FFmpeg的参数设置通常在C API调用时通过结构体和函数参数完成。在Go中，你需要将相应的C结构体映射为Go的结构体，并适当处理内存分配和释放。
- **文件目录**
```text
├─example-------示例代码目录
│  └─exp
├─ffmpeg--------视频处理（转换、压缩、剪辑、合并等）
├─ffprobe-------视频详情（视频流、音频流、尺寸、大小、高宽度等）
└─utils---------工具函数类
```
### 错误处理

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

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

```go
package main

import (
   "context"
   "fmt"
   "gitee.com/bobo-rs/goffmpeg/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文档进行开发。