ESP32-CAM WebCam

一个适用于ESP32-CAM的Android客户端应用，提供完整中文界面，用于控制和查看ESP32-CAM摄像头。

English Version (英文版)

📸 功能特性

• 中文界面：完全汉化的用户界面，适合中文用户使用
• 实时视频流：通过WiFi连接直接查看ESP32-CAM的实时视频流
• 拍摄照片：捕获高质量静态图像并保存至相册
• 自定义存储：可选择照片保存位置，支持创建新文件夹
• 摄像头控制：调整分辨率、亮度、对比度等参数
• 灯光控制：控制摄像头的LED灯
• 权限管理：直观的权限状态显示和一键申请功能
• 多种连接方式：支持直接连接ESP32-CAM的AP或通过局域网连接
• 摄像头信息：查看ESP32-CAM的详细系统信息
• 设置保存：保存和恢复摄像头设置

📱 应用截图

v1.0.0

v1.0.1

v1.0.2

🚀 快速开始

系统要求

• Android 6.0 (API 23)或更高版本
• 支持Android 14
• ESP32-CAM硬件
• ESP32-CAM刷入汉化版固件：XCQ0607/esp32-cam-webserver-HAN

安装方法

1. 从Releases页面下载最新APK

   • 提供了多个CPU架构的APK文件，请根据您的设备选择合适的版本：
     • arm64-v8a: 适用于大多数现代Android手机
     • armeabi-v7a: 适用于较旧的Android设备
     • x86/x86_64: 适用于基于Intel处理器的设备（如部分平板）
     • 通用版本: 包含所有架构，适用于任何设备但文件较大
   • 如果不确定您的设备架构，可以安装通用版本

2. 在Android设备上安装APK

3. 启动ESP32-CAM并确保其已启动WiFi

4. 打开应用并连接到摄像头

固件安装（必须）

本应用需要配合汉化版ESP32-CAM固件使用：

1. 克隆固件仓库：git clone https://github.com/XCQ0607/esp32-cam-webserver-HAN.git
2. 使用PlatformIO打开项目并编译
3. 将编译好的固件刷写到ESP32-CAM硬件
4. 刷写完成后，ESP32-CAM将自动启动并创建WiFi热点

💻 连接摄像头

接入点模式 (推荐)

1. 在应用中，进入"设置"页面
2. 配置IP地址为192.168.4.1(ESP32-CAM的默认AP IP)
3. 确保HTTP端口为80，流媒体端口为81
4. 点击"测试连接"
5. 连接成功后，返回主页面开始使用

局域网模式

1. 确保ESP32-CAM连接到与您手机相同的WiFi网络
2. 在应用中，进入"设置"页面
3. 输入ESP32-CAM在您局域网中的IP地址
4. 测试连接并开始使用

🔍 使用指南

主界面

• 启动/停止视频：控制视频流的开启和关闭
• 拍摄照片：捕获当前画面的静态图像
• 保存到相册：将捕获的图像保存到手机相册
• 相机控制：调整分辨率、亮度、对比度等参数
• 重启摄像头：远程重启ESP32-CAM

设置界面

• 连接设置：配置IP地址和端口
• 预设连接：保存和加载常用连接配置
• 图像设置：调整图像质量、分辨率等

故障排除

• 如果连接失败，请检查ESP32-CAM是否已启动并可访问
• 确认IP地址和端口设置正确
• 如果视频流不显示，请尝试刷新或重启摄像头
• 对于AP模式，确保您的手机已连接到ESP32-CAM的WiFi网络

🔧 开发者信息

技术栈

• 语言：Kotlin
• UI框架：Jetpack Compose
• 网络：Ktor客户端
• 异步处理：Kotlin协程

项目结构

app/
├── src/main/
│   ├── java/com/kust/webcam/
│   │   ├── data/              # 数据层（模型、存储库）
│   │   ├── domain/            # 领域层（视图模型、用例）
│   │   ├── ui/                # UI层（界面、组件）
│   │   │   ├── components/    # 可复用UI组件
│   │   │   ├── screens/       # 主要界面
│   │   │   └── theme/         # 应用主题
│   │   └── utils/             # 工具类和扩展
│   └── res/                   # 资源文件
└── build.gradle               # 项目构建文件

构建项目

1. 克隆仓库：

   git clone https://github.com/XCQ0607/WebCam.git
   

2. 使用Android Studio打开项目

3. 同步Gradle并构建项目

4. 运行应用到连接的设备或模拟器

5. 生成发布版APK：

   ./gradlew assembleRelease
   

   生成的APK文件将位于app/build/outputs/apk/release/目录下，包含多个针对不同CPU架构的版本

📋 许可证

本项目采用 MIT 许可证

🙏 致谢

• ESP32-CAM Webserver - ESP32-CAM原始固件

相关硬件

• XCQ0607/esp32-cam-webserver-HAN - 汉化版ESP32-CAM固件

Star History