CameraWebServer是乐鑫 Arduino-ESP32 内核官方自带原生示例工程是 ESP32/ESP32-S3 做网页 IP 摄像头最基础、入门首选的流媒体程序内置完整摄像头驱动、WiFi、HTTP MJPEG 视频流、网页控制面板。一、CameraWebServer项目说明1. 项目基础定位来源Arduino IDE 路径文件 → 示例 → ESP32 → Camera → CameraWebServer随 ESP32 板库一起安装无需额外下载第三方库。核心作用ESP 芯片驱动 DVP 摄像头OV2640/OV3660 等搭建 80 端口 Web 服务浏览器打开即可实时查看 MJPEG 视频流、在线调节图像参数、抓拍单帧照片。适配芯片ESP32、ESP32-S2、ESP32-S3完美支持 N16R8 带 PSRAM必须带 PSRAM 才能跑 QVGA/VGA 等高分辨率无 PSRAM 仅能极小尺寸画面。网页控制面板界面2. 整体代码结构工程一共 4 个文件CameraWebServer.ino主入口WiFi 初始化、摄像头参数配置、Web 服务路由注册、主循环server.handleClient()轮询客户端请求。camera_pins.h预制各大开发板引脚映射宏S3-EYE、AI-Thinker、M5、通用 S3-WROOM 全部预设好 GPIO 定义开启对应宏自动加载引脚配置。app_httpd.cppHTTP 后端核心MJPEG 长连接分片推流、单帧快照、接收网页调节指令、图像参数下发。camera_index.h内置压缩 HTML 前端页面字符串形式嵌入代码包含视频窗口、滑动调节条、功能按钮无外部文件依赖。3. 核心功能清单实时 MJPEG 流媒体无插件浏览器直接看拍照JPEG录像存浏览器分辨率调节OV3660 支持UXGA(2048×1536)、SXGA、QVGA亮度 / 对比度 / 饱和度 / 锐度夜间模式、特效、白平衡人脸检测最牛的内置功能无需训练无需模型文件网页画框显示人脸闪光灯控制4. 运行工作流程上电 → 串口初始化 → WiFi 连接打印分配 IP根据开启的板型宏加载 GPIO 引脚配置填充camera_config_t结构体调用esp_camera_init()启动 DVP 摄像头初始化 WebServer (80 端口)注册/、/stream、/capture、参数调节路由进入loop()死循环持续server.handleClient()处理浏览器 HTTP 请求客户端访问/stream时开启长循环采集帧、JPEG 编码、TCP 分片持续下发画面5. 优势与短板优势零额外依赖官方自带不用装第三方库Arduino/PlatformIO 一键编译上手极快只改 WiFi 密码 切换板型宏就能跑通画面可视化调试强网页实时调画质参数排查供电、时序问题直观适配广泛所有主流 ESP 摄像头开发板引脚全部预制可快速二次开发叠加 GPIO 继电器、SD 卡存截图、简单识别逻辑明显短板单线程阻塞模型所有 WiFi、网页、摄像头采集挤在同一个loop()调度多浏览器同时打开页面、WiFi 负载高时采集任务被抢占WROOM 电气差直接卡顿断流而 ESP-IDF/rzeldent 用 FreeRTOS 多核分离任务。只有 HTTP-MJPEG无原生 RTSP延迟偏高600ms~2s不兼容 NVR 监控录像机、HA 专业流媒体链路RTSP 必须自己额外移植库。容错弱摄像头初始化轻微时序不稳、长线干扰、电源噪声时容易卡死采集ESP-WHO、官方 esp_video 驱动自带重试、相位校正容错。Arduino 层内存开销更大 对比原生 ESP-IDFArduino 内核占用堆内存更高PSRAM 带宽竞争更激烈S3-WROOM 外接硬件短板被放大。无鉴权保护 默认任何人连局域网都能打开摄像头画面没有账号密码登录。6. rzeldent/esp32cam-rtsp 简易对比项目框架协议多任务延迟稳定度上手难度CameraWebServerArduino 官方HTTP MJPEG单线程高一般极低rzeldent esp32cam-rtspArduino(PIO)RTSPHTTPFreeRTOS 多核低高低ESP-IDF esp_video原生 IDFHTTP MJPEG多核调度中极高中二、测试硬件平台1. ESP-S3-EYE 平台(兼容)使用兼容ESP-S3-EYE 的开发板 CHDESP-S3-EYE运行测试相关官方示例基本没有问题测试后再移植测试第三方开发板。摄像头OV3660300 万像素2. ESPS3-N16R8-CAMESP32-S3 WROOM OV3660 开发板常用的 Camera 定义//Camera Config #define CAMERA_PIN_D0 GPIO_NUM_11 #define CAMERA_PIN_D1 GPIO_NUM_9 #define CAMERA_PIN_D2 GPIO_NUM_8 #define CAMERA_PIN_D3 GPIO_NUM_10 #define CAMERA_PIN_D4 GPIO_NUM_12 #define CAMERA_PIN_D5 GPIO_NUM_18 #define CAMERA_PIN_D6 GPIO_NUM_17 #define CAMERA_PIN_D7 GPIO_NUM_16 #define CAMERA_PIN_XCLK GPIO_NUM_15 #define CAMERA_PIN_PCLK GPIO_NUM_13 #define CAMERA_PIN_VSYNC GPIO_NUM_6 #define CAMERA_PIN_HREF GPIO_NUM_7 #define CAMERA_PIN_SIOC GPIO_NUM_5 #define CAMERA_PIN_SIOD GPIO_NUM_4 #define CAMERA_PIN_PWDN GPIO_NUM_NC #define CAMERA_PIN_RESET GPIO_NUM_NC #define XCLK_FREQ_HZ 20000000三、Arduino IDE 操作步骤开发板ESP32-S3 EVB摄像头OV3660300 万像素比 OV2640 高级示例Arduino → 文件 → 示例 → ESP32 → Camera → CameraWebServer这个示例原生支持 OV3660 ESP32-S3只需要修改 2 处代码就能直接跑。第一步打开示例Arduino IDE 操作文件 → 示例 → ESP32 → Camera → CameraWebServer打开后是一个巨大的.ino文件我们只改关键区域。第二步配置摄像头型号找到代码里这一段大约第 10~30 行// // Select camera model // //#define CAMERA_MODEL_WROVER_KIT // Has PSRAM //#define CAMERA_MODEL_ESP_EYE // Has PSRAM #define CAMERA_MODEL_ESP32S3_EYE // Has PSRAM //#define CAMERA_MODEL_M5STACK_PSRAM // Has PSRAM //#define CAMERA_MODEL_M5STACK_V2_PSRAM // M5Camera version B Has PSRAM //#define CAMERA_MODEL_M5STACK_WIDE // Has PSRAM //#define CAMERA_MODEL_M5STACK_ESP32CAM // No PSRAM //#define CAMERA_MODEL_M5STACK_UNITCAM // No PSRAM //#define CAMERA_MODEL_AI_THINKER // Has PSRAM //#define CAMERA_MODEL_TTGO_T_JOURNAL // No PSRAM //#define CAMERA_MODEL_XIAO_ESP32S3 // Has PSRAM#define CAMERA_MODEL_ESP32S3_EYE因为ESP32-S3-WROOM OV3660 官方匹配型号就是这个。兼容板与第三方都选这个配置第三步修改 WiFi 信息找到const char* ssid ********; const char* password ********;改成你自己的路由器 WiFi。第四步板卡配置Arduino 中工具 → 开发板 → ESP32 Arduino → ESP32S3 Dev ModuleFlash/PSRAM 及其他配置项参考下方图示第五步上传 运行把 ESP32-S3 开发板插电脑选择正确串口点击上传注如果上传中断或错误需要让板卡进入下载模式先按 BOOT 键不放再按 RST松开 RST 就进入下载模式最后放 BOOT上传成功后打开串口监视器115200 波特率你会看到ESP32-S3-EYE 兼容板启动信息第三方开发板启动信息