Hercules 项目下载及安装教程

1. 项目介绍

Hercules 是一个以 JSON 和 Lua 脚本灵活控制视频混画混流 MCU 的开源项目。它通过 Lua 脚本实现基础接口的封装，并使用 JSON 灵活控制调用参数，以达到所需的画面效果。该项目主要功能包括混画和混音，已在虎牙内部多个核心业务中广泛使用，支持的业务量每天在数万个。

2. 项目下载位置

Hercules 项目的源代码托管在 GitHub 上。你可以通过以下命令克隆项目到本地：

git clone https://github.com/HuyaInc/Hercules.git

3. 项目安装环境配置

3.1 系统要求

Hercules 项目目前主要支持 Linux 系统，建议使用 Ubuntu 或 CentOS 等主流 Linux 发行版。

3.2 依赖库安装

在编译 Hercules 项目之前，需要安装一些第三方依赖库。以下是安装步骤：

3.2.1 安装依赖库

sudo apt-get update
sudo apt-get install -y build-essential cmake git

3.2.2 安装第三方库

Hercules 项目依赖于以下第三方库：

• FFmpeg
• OpenCV
• FreeImage
• x264
• fdk_aac
• FreeType
• libjsoncpp
• OpenSSL
• SRS

你可以通过以下命令安装这些库：

sudo apt-get install -y libavcodec-dev libavformat-dev libswscale-dev libopencv-dev libfreeimage-dev libx264-dev libfdk-aac-dev libfreetype6-dev libjsoncpp-dev libssl-dev

3.3 环境配置示例

以下是环境配置的示例图片：

4. 项目安装方式

4.1 编译项目

进入项目目录并创建编译目录：

cd Hercules
mkdir bin && cd bin

4.2 生成构建文件

使用 CMake 生成构建文件：

cmake -DCMAKE_BUILD_TYPE=Debug/Release -DADD_THIRD_PARTY="ON" ..

4.3 编译并安装

编译并安装项目：

make && make install

4.4 运行示例

进入示例目录并编译示例程序：

cd ../demo
mkdir bin && cd bin
cmake ..
make

5. 项目处理脚本

Hercules 项目使用 Lua 脚本和 JSON 配置文件来控制视频混画和混音。以下是一个简单的 Lua 脚本示例：

-- 加载配置文件
local config = require("config")

-- 初始化混画器
local mixer = require("mixer")
mixer.init(config)

-- 添加视频输入
mixer.add_input("video1", "input1.mp4")
mixer.add_input("video2", "input2.mp4")

-- 设置输出
mixer.set_output("output.mp4")

-- 开始混画
mixer.start()

通过修改 Lua 脚本和 JSON 配置文件，你可以实现各种复杂的混画和混音效果。

---

以上是 Hercules 项目的下载及安装教程，希望对你有所帮助。