pp-avp - 音视频处理技能

pp-avp 是 pp-audio-video-processor 的缩写，是一个基于 FFmpeg 的专业音视频处理技能包。

技能名称说明

• 简短名称: pp-avp
• 完整名称: pp-audio-video-processor
• 用途: 提供音视频格式转换、剪辑、压缩、滤镜效果等功能

功能概述

本技能基于FFmpeg提供全面的音视频处理能力，包括但不限于：

视频处理

• 视频压缩与转码
• 分辨率调整
• 视频剪辑（时间范围截取）
• 视频裁剪（空间区域裁剪）
• 添加水印（图片/文字）
• 视频格式转换
• 视频合并与分割
• 视频转GIF/WebP
• 提取视频帧

音频处理

• 音频格式转换
• 音频剪辑
• 音量调整
• 淡入淡出效果
• 音频提取（从视频中）
• 音频合并与混音
• 采样率/声道转换

图像处理

• 图像格式转换
• 图像缩放与裁剪
• 图像旋转与滤镜
• 图像水印添加

使用方法

1. 视频压缩

ffmpeg -i input.mp4 -c:v libx264 -preset slow -crf 23 -c:a copy output.mp4

2. 视频格式转换

# MP4转AVI
ffmpeg -i input.mp4 -c:v libx264 -c:a aac output.avi

# MP4转WebM
ffmpeg -i input.mp4 -c:v libvpx -c:a libvorbis output.webm

3. 视频剪辑

# 从30秒到60秒
ffmpeg -i input.mp4 -ss 00:00:30 -to 00:01:00 -c copy output.mp4

# 前30秒
ffmpeg -i input.mp4 -t 30 -c copy output.mp4

4. 调整分辨率

# 缩放到720p
ffmpeg -i input.mp4 -vf "scale=1280:720" -c:v libx264 -crf 23 output.mp4

# 保持宽高比
ffmpeg -i input.mp4 -vf "scale=1280:-1" -c:v libx264 -crf 23 output.mp4

5. 添加水印

# 图片水印
ffmpeg -i input.mp4 -i watermark.png -filter_complex "overlay=10:10" -c:v libx264 -crf 23 output.mp4

# 文字水印
ffmpeg -i input.mp4 -vf "drawtext=text='Watermark':fontsize=24:fontcolor=white:x=10:y=10" -c:v libx264 -crf 23 output.mp4

6. 提取音频

# 保持原格式
ffmpeg -i input.mp4 -vn -acodec copy output.aac

# 转换为MP3
ffmpeg -i input.mp4 -vn -c:a libmp3lame -b:a 128k output.mp3

7. 音频格式转换

# WAV转MP3
ffmpeg -i input.wav -c:a libmp3lame -b:a 128k output.mp3

# FLAC转AAC
ffmpeg -i input.flac -c:a aac -b:a 128k output.m4a

8. 调整音量

# 增加音量
ffmpeg -i input.mp3 -af "volume=2.0" output.mp3

# 降低音量
ffmpeg -i input.mp3 -af "volume=0.5" output.mp3

9. 视频转GIF

# 基础转换
ffmpeg -i input.mp4 -r 10 output.gif

# 优化GIF（推荐）
ffmpeg -i input.mp4 -vf "scale=640:-1" -r 10 output.gif

10. 提取视频帧

# 提取第10秒的帧
ffmpeg -i input.mp4 -ss 00:00:10 -vframes 1 -q:v 2 output.jpg

# 每秒提取一帧
ffmpeg -i input.mp4 -vf "fps=1" frame_%04d.jpg

11. 视频合并

# 使用concat demuxer
echo "file 'video1.mp4'" > list.txt
echo "file 'video2.mp4'" >> list.txt
ffmpeg -f concat -safe 0 -i list.txt -c copy output.mp4

常用参数说明

视频编码参数

音频编码参数

时间控制参数

滤镜参数

编码预设说明

x264预设（速度/质量权衡）

CRF值说明

• CRF范围: 0-51
• 值越小: 质量越好，文件越大
• 推荐值: 23（默认）
• 高质量: 18-22
• 高压缩: 24-28

支持的格式

视频格式

• 输入: MP4, AVI, MOV, MKV, FLV, WebM, WMV, 3GP
• 输出: MP4, AVI, MOV, MKV, FLV, WebM, GIF, WebP

音频格式

• 无损: WAV, FLAC, ALAC, AIFF
• 有损: MP3, AAC, OGG, Opus, WMA
• 专业: AC3, DTS

图像格式

• JPEG, PNG, WebP, BMP, GIF

高级功能

1. 硬件加速

# NVIDIA NVENC
ffmpeg -hwaccel cuda -i input.mp4 -c:v h264_nvenc -preset p7 -cq 23 output.mp4

# Intel QSV
ffmpeg -hwaccel qsv -i input.mp4 -c:v h264_qsv -preset medium -global_quality 23 output.mp4

2. 批量处理

# 批量转换格式
for file in *.wav; do
    ffmpeg -i "$file" -c:a libmp3lame -b:a 128k "${file%.wav}.mp3"
done

3. 流媒体处理

# RTMP推流
ffmpeg -re -i input.mp4 -c:v libx264 -preset ultrafast -tune zerolatency -c:a aac -f flv rtmp://server/live/stream

# HLS输出
ffmpeg -i input.mp4 -c:v libx264 -c:a aac -f hls -hls_time 2 -hls_list_size 5 output.m3u8

参考文档

本技能包含完整的FFmpeg参考文档，位于 references/ 目录下：

• FFmpeg安装使用教程
• [FFmpeg从入门到精通完整教程](references/FFmpeg 从入门到精通完整教程.md)

这些文档已集成到技能包中，可随时离线查阅。

使用注意事项

1. FFmpeg安装: 确保系统已安装FFmpeg（版本>=4.0）
2. 文件路径: 使用绝对路径或相对于当前目录的路径
3. 覆盖警告: 使用 -y 参数覆盖已存在的输出文件
4. 编码时间: 高质量编码可能需要较长时间
5. 硬件加速: 建议使用GPU加速提高处理速度
6. 音频质量: 转换有损格式时注意比特率设置

示例场景

场景1：压缩视频文件

ffmpeg -i input.mp4 -c:v libx264 -preset slow -crf 23 -c:a copy output_compressed.mp4

场景2：从视频提取音频并转换格式

ffmpeg -i input.mp4 -vn -c:a libmp3lame -b:a 192k output.mp3

场景3：调整视频分辨率并添加水印

ffmpeg -i input.mp4 -i logo.png -vf "scale=1280:720" -filter_complex "overlay=10:10" -c:v libx264 -crf 23 -c:a copy output.mp4

场景4：批量转换音频格式

for file in *.flac; do
    ffmpeg -i "$file" -c:a aac -b:a 128k "${file%.flac}.m4a"
done

提示: 当用户请求音视频处理相关操作时，使用 RunCommand 工具执行FFmpeg命令。根据用户的具体需求选择合适的命令参数。