【亲测免费】 RTC-AIGC-嵌入式演示项目安装与配置指南

RTC-AIGC-嵌入式演示项目安装与配置指南

1. 项目基础介绍

本项目是一个实时对话式AI硬件演示项目，旨在展示如何在嵌入式设备上实现实时音视频通信与AI交互功能。项目主要使用C和Python编程语言。

2. 项目使用的关键技术和框架

• 实时音视频通信：使用Volcengine的RTC服务，实现实时音视频的传输。
• AI交互：利用Volcengine的大模型推理服务，进行语音识别和语音合成。
• 硬件平台：基于乐鑫ESP32-S3-Korvo-2开发板。
• 软件框架：使用乐鑫ADF（Audio Development Framework）框架进行开发。

3. 项目安装和配置准备工作

硬件要求

• PC服务器（Linux建议使用ubuntu18.04及以上版本）
• 乐鑫ESP32-S3-Korvo-2开发板
• USB数据线（两条A转Micro-B数据线，一条作为电源线，一条作为串口线）

软件要求

• Python环境（建议使用Python 3）
• CMake和Ninja编译工具
• ESP-IDF工具链
• Volcengine提供的API密钥和App ID等信息

详细安装步骤

步骤1：配置服务端

1. 在PC服务器上安装Python环境，确保pip工具可用。

2. 使用pip安装requests库：

   pip install requests
   

3. 克隆实时对话式AI硬件Demo示例代码：

   git clone https://github.com/volcengine/rtc-aigc-embedded-demo.git
   

4. 进入服务端Demo目录：

   cd rtc-aigc-embedded-demo/server/src
   

5. 配置服务端配置文件RtcAigcConfig.py，设置API密钥、App ID等信息：

   AK = "your_access_key"
   SK = "your_secret_key"
   RTC_APP_ID = "your_rtc_app_id"
   RTC_APP_KEY = "your_rtc_app_key"
   DEFAULT_BOT_ID = "your_bot_id"
   DEFAULT_VOICE_ID = "your_voice_id"
   ASR_APP_ID = "your_asr_app_id"
   TTS_APP_ID = "your_tts_app_id"
   PORT = 8080
   

6. 运行服务端：

   python3 RtcAigcService.py
   

步骤2：配置设备端

1. 在PC上安装CMake和Ninja编译工具：

   brew install cmake ninja dfu-util
   

2. 克隆乐鑫ADF框架并同步子仓代码：

   git clone https://github.com/espressif/esp-adf.git
   cd esp-adf
   git submodule update --init --recursive
   

3. 安装乐鑫esp32s3开发环境相关依赖：

   ./install.sh esp32s3
   

4. 设置环境变量：

   ./export.sh
   

5. 将实时对话式AI硬件示例工程clone到乐鑫ADF examples目录下：

   cd $ADF_PATH/examples
   git clone https://github.com/volcengine/rtc-aigc-embedded-demo.git
   

6. 打开设备端配置文件Config.h，设置服务端地址、大模型EndPointId等信息：

   #define DEFAULT_SERVER_HOST "your_server_host:port"
   #define DEFAULT_BOT_ID "your_bot_id"
   #define DEFAULT_VOICE_ID "your_voice_id"
   #define DEFAULT_RTC_APP_ID "your_rtc_app_id"
   

7. 禁用乐鑫工程中的火山组件：

   cd $ADF_PATH
   git apply $ADF_PATH/examples/rtc-aigc-embedded-demo/0001-fix-disable-volc-engine-in-esp.patch
   git apply $ADF_PATH/examples/rtc-aigc-embedded-demo/0001-add-atoms3r-board.patch
   

8. 编译固件：

   cd $ADF_PATH/examples/rtc-aigc-embedded-demo/client/espressif/esp32s3_demo
   idf.py set-target esp32s3
   idf.py menuconfig
   idf.py build
   

9. 烧录并运行示例Demo：

   idf.py flash
   idf.py monitor
   

按照以上步骤操作，即可完成项目的安装和配置。