用途:录制真实屏幕内容(全桌面、指定区域或命名窗口)为 MP4 视频,可选系统音频与光标捕捉;次要用途是程序化生成动画演示视频。
主要能力:FFmpeg 主方案使用各平台原生采集接口,支持区域/窗口录制、音频采集、光标绘制、时长控制与画质调节;无 FFmpeg 时可用 mss + OpenCV 回退方案截图合成视频(无音频、无光标、帧率较低、文件较大);还可通过 Pillow + MoviePy 生成合成动画视频,并可用 FFmpeg 做压缩、裁剪、转 GIF、加文字叠加、提取音频、拼接片段等后处理。
使用方式:主方案需先安装 FFmpeg——Windows 用 choco install ffmpeg,macOS 用 brew install ffmpeg,Linux 用 apt install ffmpeg,可用 ffmpeg -version 验证。全屏录制示例(Windows):ffmpeg -f gdigrab -framerate 30 -draw_mouse 1 -i desktop -c:v libx264 -preset ultrafast -crf 23 -pix_fmt yuv420p -t 30 recording.mp4 -y;macOS 用 -f avfoundation -capture_cursor 1 -i "0";Linux X11 用 -f x11grab -i :0.0,Wayland 需用 wf-recorder。区域录制在 Windows 用 -offset_x/-offset_y/-video_size,macOS 用 -vf crop,Linux 用 :0.0+X,Y。窗口录制在 Windows 可用 -i title="My App"。音频设备名因系统而异,可分别用 dshow、avfoundation 或 pactl list short sources 检测。停止方式为 -t 指定秒数,或向进程发送 SIGINT。Python 回退方案需 pip install mss opencv-python numpy;合成视频需 pip install "moviepy>=2.0" pillow pyttsx3。
适用场景:演示录制、教程素材、屏幕操作记录、分享用视频或 GIF、无真实录屏时的动画演示生成。
限制:主方案必须安装 FFmpeg;Windows 音频需启用 Stereo Mix;macOS 需授予屏幕录制权限;Wayland 下 x11grab 不可用;Linux x11grab 音频需 PulseAudio;Python 回退无音频与光标、帧率通常 15–25、文件更大。常见问题(找不到 FFmpeg、黑屏空视频、文件过大、MoviePy 导入错误)均有对应处理方式。具体各平台完整命令与细节见随附引用文件。