Skip to content

配置 FFmpeg

FFmpeg 是什么?

FFmpeg 是知名的开源音视频处理库,被用于许多音视频编解码相关的项目中。

为什么要使用 FFmpeg?

本项目使用 FFmpeg 是为了编解码语音和视频,以使 NapCat 以 QQ 支持的格式处理语音和视频文件。

如果你的 Bot 没有处理语音和视频的需求,可以选择不安装 FFmpeg。

安装 FFmpeg

Windows 系统

  1. 此处 下载ffmpeg-master-latest-win64-gpl.zip

  2. 将其中的文件夹解压至一个你知道的地方(例如 C:\Program Files),然后重命名为 ffmpeg

  3. 你的 ffmpeg 文件夹的结构看起来应该是这样的:

    text
    ffmpeg
    |___bin
    |___|___ffmpeg.exe
    |___|___ffplay.exe
    |___\___ffprobe.exe
    |___doc
    |___\ ...
    |___LICENSE
    \___README.txt

    注意

    请一定要保证 bin 文件夹内同时包含 ffmpeg.exeffplay.exe 以及 ffprobe.exe 否则会产生意想不到的错误。

  4. 添加bin目录到系统环境变量 不会可以搜索系统设置环境变量

如果有其他程序也需要使用 FFmpeg

如果其他程序支持手动选择 FFmpeg 位置,只需配置为 NapCat 所使用的 FFmpeg 即可。

如果其他程序不支持手动选择 FFmpeg 位置,只需将 FFmpeg 的 bin 目录注册到系统的 PATH 变量中(可参考 此教程)即可。

如果你将 FFmpeg 安装到了系统变量中,那么无论有没有在 NapCat 中配置 FFmpeg 路径也可以正常使用 FFmpeg。

Linux 系统

请使用你所使用的系统的包管理器直接安装 ffmpeg 即可正常使用。

macOS 系统

由于系统存在沙盒机制,无法运行外部程序,因此暂不支持。