# jumper

**Repository Path**: DragonCodingPlus/jumper

## Basic Information

- **Project Name**: jumper
- **Description**: 跳绳应用，支持自动计数功能。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-17
- **Last Updated**: 2026-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 跳绳计数器 Android 应用

一款基于 MediaPipe 姿态识别的智能跳绳计数应用。

## 功能特性

- ⏱️ **计时功能**: 1分钟倒计时
- 🔢 **自动计数**: 通过摄像头姿态识别自动统计跳绳次数
- 👆 **手动计数**: 支持手动点击计数作为备选
- 📊 **数据统计**: 记录历史成绩和最好成绩
- 🎨 **Material Design**: 现代化UI设计

## 技术栈

- **语言**: Kotlin
- **UI框架**: Jetpack Compose + Material Design 3
- **姿态识别**: Google MediaPipe Pose
- **摄像头**: CameraX
- **数据存储**: Room Database
- **架构**: MVVM

## 项目结构

```
app/src/main/java/com/example/jumprope/
├── MainActivity.kt                    # 主Activity
├── ui/
│   ├── theme/                         # 主题配置
│   ├── screens/                       # 界面
│   │   ├── MainScreen.kt              # 主界面
│   │   ├── HistoryScreen.kt           # 历史记录
│   │   └── StatsScreen.kt             # 统计数据
│   ├── components/                    # UI组件
│   └── navigation/                    # 导航
├── viewmodel/
│   └── JumpRopeViewModel.kt           # 核心ViewModel
├── service/
│   ├── PoseDetectionService.kt        # 姿态识别服务
│   └── JumpCounterService.kt          # 跳跃计数服务
├── data/
│   ├── model/                         # 数据模型
│   ├── local/                         # 数据库
│   └── repository/                    # 数据仓库
└── util/
    ├── Constants.kt                   # 常量定义
    └── JumpDetector.kt                # 跳跃检测算法
```

## 开发环境要求

- Android Studio Hedgehog 或更高版本
- JDK 17
- Android SDK API 34
- Gradle 8.2

## 构建运行

```bash
# 清理构建
./gradlew clean

# 构建Debug版本
./gradlew assembleDebug

# 安装到设备
./gradlew installDebug
```

## 权限说明

- `CAMERA`: 用于摄像头捕捉跳绳动作
- `RECORD_AUDIO`: 用于声音辅助计数(可选)

## 使用说明

1. 授予摄像头权限
2. 将手机放置在合适位置,确保全身入镜
3. 点击"开始"按钮
4. 开始跳绳,应用会自动计数
5. 也可切换到手动模式,点击"+1"按钮计数

## 后续优化方向

- [ ] 多人同时识别
- [ ] 声音辅助计数
- [ ] 更详细的统计分析
- [ ] 游戏化元素(成就、目标)
- [ ] 视频回放功能

## 下载

[跳绳计数器](https://gitee.com/DragonCodingPlus/jumper/releases/download/V1.0/Jumper-1.0.apk)

[产品](https://mjlong123.top/products/jumper)

[作者](https://mjlong123.top)