Android Kotlin ESP32 Version

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

English Version (英文版)

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

• 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 Chart