longandCursor
2beace89f4
之前误将训练模块加在 uniapp 项目,实际目标项目是 TUICallKit-Vue3 (甄养堂主小程序壳),整体迁入: - hooks/useMetronome.ts 节拍器(音频实例池+预热,无冷启动延迟) - hooks/useTrainingSession.ts 训练 Session 状态机 - hooks/useVoiceCoach.ts 语音教练队列 - hooks/useTrainingBgm.ts 训练/休息 BGM 切换+渐变 - pages/training/index.vue 练一练主页(器械跟练) - pages/training/metronome.vue 独立节拍器(老人友好版, 中央圆即开始/暂停按钮,纯 CSS 几何 icon,大字大按钮) - pages/training/components/exercise-anim.vue CSS 动作动画 - pages/training/exercises.ts 5 个器械动作预设 - static/training/audio/*.mp3 3 种 click 音色(MIT 协议) - scripts/generate-voice.mjs MiMo TTS 批量生成语音脚本 - pages.json 注册 pages/training/index 与 pages/training/metronome - 「我的」页加 DevTrainingEntry 悬浮入口,生产环境自动隐藏 Co-authored-by: Cursor <cursoragent@cursor.com>
106 lines
3.5 KiB
Markdown
106 lines
3.5 KiB
Markdown
# 训练模块静态资源
|
||
|
||
本目录用于存放"练一练"功能的所有音频素材。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
src/static/training/
|
||
├── audio/
|
||
│ └── click.mp3 # 节拍器主音（短促金属敲击声，约 50ms）
|
||
├── voice/
|
||
│ ├── numbers/
|
||
│ │ └── 1.mp3 ~ 30.mp3 # 数字报数
|
||
│ └── prompts/
|
||
│ ├── start.mp3
|
||
│ ├── ready.mp3
|
||
│ ├── rest.mp3
|
||
│ ├── next-set.mp3
|
||
│ ├── last-rep.mp3
|
||
│ ├── keep-it-up.mp3
|
||
│ ├── good-job.mp3
|
||
│ ├── breathe-in.mp3
|
||
│ └── breathe-out.mp3
|
||
└── bgm/
|
||
├── train-light.mp3 # 训练时背景乐（轻快有节奏感）
|
||
└── rest-meditation.mp3 # 休息时背景乐（舒缓冥想）
|
||
```
|
||
|
||
## 准备步骤
|
||
|
||
### 1. 语音素材（小米 MiMo TTS 自动生成）
|
||
|
||
需要 Node 18+（用内置 `fetch`）。先准备小米 MiMo API Key：
|
||
|
||
- 文档: https://platform.xiaomimimo.com/
|
||
- API Key 形如 `sk-xxxxxxxx`
|
||
|
||
```bash
|
||
export MIMO_API_KEY=sk-your-key-here
|
||
|
||
cd uniapp
|
||
node scripts/generate-voice.mjs
|
||
```
|
||
|
||
会自动调用 `mimo-v2.5-tts` 模型生成 39 个 mp3（30 个数字 + 9 个口令）到 `voice/` 目录。
|
||
|
||
**可选参数**：
|
||
|
||
```bash
|
||
# 换音色（默认 冰糖；可选：冰糖/茉莉/苏打/白桦/Mia/Chloe/Milo/Dean）
|
||
node scripts/generate-voice.mjs --voice 茉莉
|
||
|
||
# 换格式（默认 mp3，需要跟 hooks/useVoiceCoach.ts 里的 .mp3 后缀对应）
|
||
node scripts/generate-voice.mjs --format wav
|
||
|
||
# 强制重新生成（默认存在则跳过）
|
||
node scripts/generate-voice.mjs --force
|
||
```
|
||
|
||
**音色推荐**（中文女声更适合健身教练）：
|
||
- `冰糖`：温柔甜美，亲和力强（默认）
|
||
- `茉莉`：清爽利落，有"运动博主"感
|
||
- `苏打`：年轻男声，有力量感
|
||
- `白桦`：成熟男声，沉稳
|
||
|
||
### 2. 节拍器 click 音
|
||
|
||
**已内置 3 种音色**（来自 [chrono-bump](https://github.com/johnnysn/chrono-bump) MIT 协议项目）：
|
||
|
||
| 文件 | 用途 | 大小 |
|
||
|------|------|------|
|
||
| `audio/click.mp3` | 默认 click（标准节拍器音） | 3.4 KB |
|
||
| `audio/click-soft.mp3` | 柔和音色 | 4.2 KB |
|
||
| `audio/click-wood.mp3` | 木鱼/原木质感（推荐用于重音 accent） | 4.6 KB |
|
||
|
||
如果想换更好听的，可以去：
|
||
- [freesound.org](https://freesound.org) 搜 "click" / "tick"（注意 CC 协议）
|
||
- [pixabay.com/sound-effects](https://pixabay.com/sound-effects/) 搜 "metronome"（免费可商用）
|
||
|
||
替换时保持文件名不变即可，无需改代码。
|
||
|
||
### 3. 背景音乐
|
||
|
||
每首 30 秒~2 分钟即可（loop 后听不出接缝）。
|
||
|
||
推荐来源（免费可商用）：
|
||
- [pixabay.com/music](https://pixabay.com/music) 搜 "calm" / "meditation" / "lofi"
|
||
- [freemusicarchive.org](https://freemusicarchive.org)
|
||
- [bensound.com](https://bensound.com)（含署名）
|
||
|
||
文件大小建议 < 1MB（mp3 128kbps 单声道即可）。
|
||
|
||
## 在代码里被引用的位置
|
||
|
||
- `src/hooks/useMetronome.ts` → `audio/click.mp3`
|
||
- `src/hooks/useVoiceCoach.ts` → `voice/numbers/*.mp3`、`voice/prompts/*.mp3`
|
||
- `src/hooks/useTrainingBgm.ts` → `bgm/*.mp3`
|
||
|
||
如需修改路径，修改对应 hook 文件里的常量即可。
|
||
|
||
## 注意事项
|
||
|
||
- 微信小程序对单个文件大小有 10MB 上限，本目录所有文件加起来建议控制在 5MB 以内。
|
||
- 小程序整包大小限制（主包 2MB / 总包 20MB），如果资源较大建议放 CDN 而非本地 static。
|
||
- 把 `useVoiceCoach.ts` 里的 `VOICE_BASE` 改成 CDN URL 即可。
|