# 乐鑫高级开发框架指南

[English]

快速入门 | 多媒体例程 | 方案中心
多媒体基础组件 | 多媒体上层组件 | 多媒体开发板

概述

ESP-ADF（Espressif Advanced Development Framework）是乐鑫官方的高级应用层开发框架，基于 ESP-IDF 与 ESP-GMF 构建，面向音频、视频与 IoT 产品的多媒体应用开发。ESP-ADF v3.0 以产品级功能、模块化服务与低资源占用为目标，提供音视频采集与播放、AI 语音、蓝牙音频、多媒体传输等方案组件；各类应用组件已发布至 IDF 组件管理器，可在工程中声明依赖后按需获取。

乐鑫高级开发框架

新特性

- 基于 ESP-GMF：媒体处理链使用 ESP-GMF 重构，在同一框架内统一音频、视频、图像与通用流式数据的处理

- 独立组件：功能组件可独立集成与运行，无需拉取整个仓库

- 产品服务：提供音频播放、视频播放、电池监控等模块化服务

- MCP 支持：产品服务可通过 Model Context Protocol（MCP）调用

- 多产品覆盖：面向音频、视频与 IoT 产品场景

- 资源占用优化：针对低内存与低 CPU 占用进行优化

- 多语言应用：支持 MicroPython、Arduino 与 C/C++ 开发

与旧版 ESP-ADF 的关系

ESP-ADF v3.0 是一次架构升级，与 ESP-ADF v2.x 在 API 与行为上不兼容。分支定位如下：

- `master`：ESP-ADF v3.0 开发主线，基于 ESP-GMF 提供组件与产品级方案案例

- `release/v2.x`：旧版 ESP-ADF（v2）维护分支，仅接收缺陷修复与小幅增强

提供有关此文档的反馈