# kidspay

**Repository Path**: zpflog/kidspay

## Basic Information

- **Project Name**: kidspay
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-25
- **Last Updated**: 2026-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KidsPay - 儿童模拟扫码支付应用

一个专为3-8岁儿童设计的模拟扫码支付Android应用，帮助培养金钱概念。

## 功能特点

### 1. 金额输入模块
- 自定义数字键盘（非系统输入法）
- 类似计算器的UI布局
- 最大输入金额：999.99元
- 小数点后最多2位
- 实时显示输入格式

### 2. 扫码支付模块
- 使用相机扫描二维码
- 支持自动对焦
- 扫描成功后语音播报
- 随机播报语音："微信到账XX元"或"支付宝到账XX元"
- 成功音效和动画反馈

### 3. 钱包管理模块
- 累计总收入显示
- 交易记录列表
- 本地数据存储（Room数据库）
- 家长控制清空记录功能

## 技术架构

- **开发语言**: Java (UI层), C++ (Native扩展)
- **开发环境**: Android Studio Koala
- **最低SDK**: API 21 (Android 5.0)
- **目标SDK**: API 29 (Android 10)
- **主要依赖**:
  - ZXing (二维码扫描)
  - Room (数据库)
  - AndroidX

## 项目结构

```
app/
├── src/main/
│   ├── java/com/kidspay/app/
│   │   ├── activity/          # Activity类
│   │   ├── adapter/           # RecyclerView适配器
│   │   ├── database/          # Room数据库
│   │   ├── model/             # 数据模型
│   │   └── utils/             # 工具类
│   ├── cpp/                   # C++ native代码
│   ├── res/                   # 资源文件
│   └── AndroidManifest.xml
└── build.gradle
```

## 构建说明

1. 使用Android Studio Koala打开项目
2. 使用国内镜像源加速依赖下载
3. Gradle版本: 5.4.1
4. Android Gradle Plugin: 3.5.2

## 配置说明

### 国内镜像源配置
项目已配置阿里云和腾讯云镜像源，位于 `build.gradle` 和 `gradle-wrapper.properties`。

### 音效文件
项目使用Android TTS (Text-to-Speech) 引擎播放语音播报，无需额外音频文件。
支付成功音效文件位于 `app/src/main/res/raw/success_sound.mp3`，如需自定义请替换该文件。

## 注意事项

1. 首次启动应用需要相机权限
2. 语音播报需要系统TTS支持
3. 交易记录存储在本地数据库中

## 开发者

专为儿童教育设计，培养金钱概念。