⾳阶练习 Beta 1.

引导⻚
引导⻚需求及技术⽂档（通⽤）点击查看
 
⽤户初次进⼊【⾳阶练习】
1. ⾳阶练习概念引导；
（补图）
2. 引导⽤户左右滑动选择⾳阶把位。
（补图）
 
⽤户初次进⼊【练习中】⻚⾯
引导⽤户按提示进⾏练习，点击结束按钮⽣成练习报告。
（补图）
 
⽤户初次关闭【节拍器】
在【练习选择】和【练习中】有节拍器⼊⼝，点击进⼊节拍器设置⻚⾯；
点击开关，关闭节拍器后引导⽤户。
（补图）
 
 
练习选择
各调式对应的根⾳选项，及各调式、根⾳、指板⾳、把位信息；点击查看
 
打开【智能教练】点击【⾳阶练习】进⼊练习选择⻚；
 
练习选择⻚组成
1. "返回" 按钮，点击回到【智能教练】主⻚；
2. tab ，常⽤推荐的调式，包括 C⾃然⼤调、G⾃然⼤调、C⼤调五声、
G⼤调五声、A⼤调五声、⾃定义；
3. 节拍器按钮；
4. 指板（选择把位）；

 5. 开始按钮，点击进⼊【练习中】⻚⾯。
 
调式、主⾳与指板
根据所选的 "调式" 与 "主⾳" ，指板上显示对应的圆点，并可左右操作指
板选择把位，其关系参考信息 点击查看
 
节拍器
点击节拍器，进⼊节拍器调节⻚⾯；点击 "取消" 或 "确认" 回到【练习选
择】⻚⾯；
其余参考【练习中】⻚⾯的节拍器说明。
 
 
练习中
⻚⾯组成
1. 关闭按钮，点击进⼊【暂停休息】⻚⾯；
2. 练习时⻓；
3. 正确数、错误数；
4. 节拍器；
5. ⽂案
1. "请按指板弹奏" ；
2. ⾳名 + 连击数；
6. 指板。
 
节拍器
1. 点击节拍器按钮进⼊节拍器调节⻚⾯，并暂停识别弹奏；
2. 节拍器⻚⾯；
1. 节拍器开关；
2. 调节 BPM ；
3. 练习⾳符时值 点击查看（练习中识别最⼩⾳符单位）；

 3. 在节拍器调节⻚点击 "取消" 或 "确认" ，回到【练习中】⻚⾯；

若开始练习后，⽤户不进⾏弹奏，则不识别；
若开始练习后，⽤户进⾏弹奏，则开始识别；
4. ⽤户关闭节拍器，识别弹奏时，不检测 "节奏准确率" 数据，只记录 "
⾳阶正确率" 、"弹奏⼒度" 、"旋律⽅向占⽐" 数据；
直到⽤户开启节拍器弹奏再检测 "节奏准确率" 数据。
 
练习时⻓
【练习中】⻚⾯停留时⻓；
若⽤户 30 秒内没有弹奏吉他，则⾃动进⼊【暂停休息】⻚；进⼊【暂停
休息】⻚后，练习时⻓暂停计时，直到⽤户回到【练习中】⻚⾯再继续计
时。
 
正确错误数
⽤户弹奏后，判断⽤户弹奏的⾳是否符合当前练习⾳阶的⾳；
若符合则正确数 +1 ；
若不符合则错误数 +1 ；
正确错误数只对当次练习计算。
 
指板
1. 指板可左右滑动选择⾳阶把位；
2. ⽤户弹奏当前选中把位的⾳后，在指板上对应的点变成绿⾊显示；
1. 显示 1.5 秒后⾃动变回⽩⾊；
2. 在绿⾊的点未⾃动变⽩之前，⽤户弹奏下⼀个⾳（⽆论是否在
⾳阶内），绿⾊的点也⻢上变成⽩⾊；
3. 弹奏当前⾳阶当前把位以外的⾳，不显示绿点。
 
⽂本
⽂本提示在指板上⽅显示。
 
"请按指板弹奏"

 1. 刚开始进⼊【练习中】⻚⾯的时候显示，包括从【练习选择】⻚进
⼊，和【暂停休息】⻚回到【练习中】的时候；
2. ⽤户 5 秒内没有弹奏吉他时显示；
3. ⽤户弹奏吉他后消失。
 
⾳名
1. ⽤户弹奏的⾳在当前所选⾳阶范围内，则显示对应的⾳名，并显示连
击次数；
2. 3 秒以内没有弹奏，连击次数中断。
 
暂停休息
1. 进⼊【暂停休息】⻚
1. 点击 "关闭" 按钮进⼊ 【暂停休息】⻚，并暂停识别；
2. ⽤户超过 30 秒不弹奏，进⼊【暂停休息】⻚，并暂停识别；
2. 【暂停休息】⻚中有休息时⻓，"结束练习" 和 "继续练习" 按钮；
3. 点击 "继续练习" 或弹奏琴弦，回到【练习中】⻚⾯；
若开始练习后，⽤户不进⾏弹奏，则不识别；
若开始练习后，⽤户进⾏弹奏，则开始识别；
4. 点击 "结束练习" 进⼊【练习结果】⻚。
 
 
 
 
练习结束
https://shimo.im/docs/vVAXV2zgXYSKGJqm
 
练习报告
https://shimo.im/docs/VMAPVmGKVZF86Zqg

 引导⻚需求及技术⽂档（通⽤）

吉他端应⽤引导⻚需求

如何进⼊引导⻚
1. ⽤户激活吉他后，⾸次初次启动应⽤；
2. 下载新的应⽤后，⾸次启动；
3. ⽤户初次点击指定按钮触发引导⻚；
4. 应⽤更新了 ⾸次启动应⽤的引导图编码及状态，⽤户更新应⽤后⾸次
启动应⽤（往下具体说明）。
 
 
引导⻚内容
引导⻚展示引导图⽚及按钮（"下⼀步" 或 "完成" 按钮），引导图⽚由 UI
提供，按钮由开发写。
 
按钮
"下⼀步" 按钮，点击切换到下⼀张引导⻚图⽚；
"完成" 按钮，点击回到进⼊引导⻚之前的⻚⾯；
点击按钮后，图⽚的切换效果：渐出、渐现。
 
图⽚
尺⼨：满屏展示尺⼨，960 x 640 像素；
格式：GIF 或 PNG；
编码：⻚⾯代号 + 版本号；
标签："已读" 或 "未读" ；
 
 
引导图 "已读" "未读" 状态说明
1. "已读" "未读" 状态存本地；
2. 若引导图为 "未读" 状态，当⽤户触发引导流程时，展示对应⻚⾯的
引导图；

 3. 在引导流程中，⽤户点击 "下⼀步" 按钮，不改变引导图的状态；

4. 在引导流程中，⽤户点击 "完成" 按钮回到应⽤功能⻚⾯，此时引导
流程的所有引导图标记为 "已读" 状态；
5. "已读" 状态的引导图⻚⾯不再展示；
 
 
应⽤更新、引导图更新
应⽤更新后，新增或更新引导图，新图需按规定设置好编码，并设为 "未读
" 状态，在对应⻚⾯触发引导流程时，展示新的引导图；引导完成后标记
为 "已读" 状态。

  
智能教练 - 练习结束及报告

练习结束
智能教练各个练习结束之后，将进⼊【练习结束】⻚。
 
1. 本次练习时⻓，仅计算当次练习在练习中⻚⾯的停留时⻓，休息⻚⾯
的时⻓不计算；
2. 分享按钮；
3. 查看报告按钮；
4. 庆祝动效。
 
 
 
分享
练习数据传到服务器后，⽣成⼆维码，扫码分享练习数据图⽚。
 
⽹络
1. 若有⽹的状态下，点击分享按钮，弹出⼆维码；
2. 若⽆⽹的状态下，点击分享按钮，弹出弹窗，显示本地预置默认⼆维
码（不可扫），⼆维码上显示⽂本和 "刷新" 按钮，⽂本提示 "请联⽹
后刷新⼆维码" 。
 
扫码⽅式
1. 微信扫码，扫码后选择分享对象（好友或群）；
2. ⼿机端扫码，扫码后进⼊对应的分享⻚⾯；
3. 其他⽅式扫码，若已安装⼿机端，则弹窗询问是否打开⼿机端；若未
安装⼿机端，则引导⽤户下载⼿机端。
 
分享图⽚内容（待定，与服务器相关）

 1. ⽤户名、头像；
2. 练习标题：和弦转换、扫弦练习、⾳阶练习、⼿指机能、听⾳练习；
3. 练习时⻓；
4. 数据；
1. 和弦转换：
2. 扫弦练习：
3. ⾳阶练习：
4. ⼿指机能：
5. 听⾳练习：
 
 
 
报告
【练习结束】⻚⾯点击 "查看报告" 按钮，进⼊【报告】⻚⾯。
 
和弦转换
1. 顶部数据信息
1. 练习标题："和弦转换练习" ；
2. 练习时间：2021 年 3 ⽉ 8 ⽇ 17:00 ；
3. 练习时⻓：100 分钟；
4. 转换正确率：65.5%；转换正确率 = 和弦识别正确总数 / 总弹
奏次数；
5. 平均转换时⻓：2.4 秒；
和弦显示 "橙⾊" 开始，切换到下⼀个和弦显示 "橙⾊" 结束，
在这之间所⽤的时⻓为 "单个和弦的转换时⻓" ；
平均转换时⻓ = 所有和弦转换的总时⻓ / 和弦识别正确总数；
2. 图表数据信息
1. 和弦转换正确率；每个和弦之间转换的平均正确率；
2. 转换正确所需时间；每个和弦之间转换的平均时⻓。

  
 
 
扫弦练习
1. 顶部数据信息
1. 练习标题："扫弦练习" ；
2. 练习时间：2021 年 3 ⽉ 8 ⽇ 17:00 ；
3. 练习时⻓：100 分钟；
4. 节奏准确率：98.8% ；节奏准确率 = 正确弹奏次数 / 总弹奏次
数；
5. 最⾼连击：100 次；
2. 图表数据信息
1. 节奏准确率；
2. 弹奏⼒度。

  
 
⾳阶练习
1. 顶部数据信息
1. 练习标题：根⾳ + ⾳阶类型名称 + "⾳阶练习" ；例： G ⼤调
⾳阶练习 ；
2. 练习时间：2021 年 3 ⽉ 8 ⽇ 17:00 ；
3. 练习时⻓：100 分钟；
4. ⾳阶正确率：98.8% ；
5. 最⾼连弹：100 次；
2. 图表数据信息
1. ⾳阶正确率；
2. 节奏准确率；
3. 弹奏⼒度；
4. 旋律⽅向占⽐；

  
⼿指机能
1. 顶部数据信息
1. 练习标题："⼿指机能练习" ；
2. 练习时间：2021 年 3 ⽉ 8 ⽇ 17:00 ；
3. 练习时⻓：100 分钟；
4. 节奏准确率：98.8% ；
5. 弹奏次数：126 次；
2. 图表数据信息
1. 节奏准确率；
2. 弹奏⼒度；
3. 旋律⽅向占⽐；

  
 
 
 
 
听⾳练习
1. 顶部数据信息
1. 练习标题："听⾳练习" ；
2. 练习时间：2021 年 3 ⽉ 8 ⽇ 17:00 ；
3. 练习时⻓：100 分钟；
4. 答题正确率：98.8% ；答题正确率 = 答对次数 / 答题总次数；
5. 平均答对时⻓：4.2 秒；
从题⽬⾳播放完毕后开始，到识别答题正确结束，在这之间所
⽤的时⻓为 "单次答对时⻓" ；
平均答对时⻓ = 所有题⽬答对时⻓总和 / 答对次数 ；
2. 图表数据信息
1. 单⾳正确率；每个题⽬⾳的答题正确率；
2. 单⾳答对时⻓；每个题⽬⾳的答对时⻓；
3. ⾳程⽅向正确率；
4. ⾳程⽅向答对时⻓；
上下⾏⾳程定义：每次出题的题⽬⾳对⽐上次题⽬⾳，若⾼于
上次题⽬⾳，则此次题⽬⾳为上⾏⾳程；若低于上次题⽬⾳，
则此次题⽬⾳为下⾏⾳程（初次出题不算在内）。

 练习结束

吉他端⻚⾯流程
1. 练习时⻓不⾜ 2 分钟，点击退出练习后，回到开始练习前的⻚⾯；
2. 练习时⻓超过 2 分钟，点击退出练习后，进⼊练习结束⻚（⼤拇
指）。
 
结束⻚⽂案
1. ⽹络正常
完成第 XXXXX 次XXX 练习
时⻓XXX分XX秒
2. ⽹络异常
本次练习时⻓XXX分XX秒
 
数据上传及⼿机端显示
1. 练习结束后将报告上传（不限练习时⻓），上传到后端；
2. ⼿机端只能查看练习时⻓超 2 分钟的报告；
3. ⼿机端统计的练习时⻓和次数，不计算练习时⻓不⾜ 2 分钟以内的数
据。