Skip to content

配置 FFmpeg

FFmpeg 是什么?

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

为什么要使用 FFmpeg?

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

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

安装 FFmpeg

Windows 系统

  1. 此处 下载官方许可的 FFmpeg;
  2. 将其中的文件夹解压至一个你知道的地方(例如 C:\Program Files),然后重命名为 ffmpeg
  3. 你的 ffmpeg 文件夹的结构看起来应该是这样的:
    ffmpeg
    |___bin
    |___|___ffmpeg.exe
    |___|___ffplay.exe
    |___\___ffprobe.exe
    |___doc
    |___\ ...
    |___LICENSE
    \___README.txt

    注意

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

  4. 启动 QQNT,前往 LLOneBot 设置页,选择 FFmpeg 为刚才解压的 ffmpeg.exe(在本例中,FFmpeg 主程序位于 C:\Program Files\ffmpeg\bin\ffmpeg.exe), 然后点击「保存」按钮;
  5. 如果没有任何错误出现,说明 FFmpeg 已经配置成功了。恭喜你!

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

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

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

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

Linux 系统

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

macOS 系统

你可以使用 Homebrew 安装 FFmpeg,也可以 在此处 手动下载二进制文件安装。

注意如果你选择手动安装,请确保你下载并安装了 FFmpegFFprobe 以及 FFplay 三个库,否则可能会产生意想不到的错误。