帮助练习钢琴视奏的应用SightReading

参考SightReading获取应用代码和详细使用方法。

类图和数据结构

SightReadingClassDiagram

标签保存在UserDefault里面，数据格式如下：

1
2
3
4
5
6

{
    "ALL_TAGS" : ["tag1", "tag2", "tag3"],
    "天空之城1" : ["tag1", "tag2"],
    "天空之城2" : ["tag2", "tag3"],
    "巴赫小步舞曲" : ["tag1"]
}

对于乐谱“天空之城1”，保存的文件名如下：

  1. 乐谱图片：天空之城1.png
  2. 笔记图片：天空之城1&-note.png
  3. 每小节位置和大小文件：天空之城1.json

其中json文件格式如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
    "basic info" : {
        "tempo" : "90", // 每分钟节拍数
        "meter" : "4", // 每小节节拍数
        "maskOffset" : "1" // Mask偏移
    },
    "bar frames" : {
        1 : CGRect(0.01, 0.02, 0.11, 0.12), // 小节序号和小节位置大小（是一个比例值，相对于整个乐谱图片的大小），最终显示的时候需要根据实际显示的乐谱的大小算出每个小节的位置和大小
        2 : CGRect(0.13, 0.03, 0.12, 0.11),
        .
        .
        .
    }
}

数据备份

  1. 百度云盘下载（/MyDocument/歌谱简谱五线谱/SightReading应用数据备份20211207/mstr.SightReading.2021-12-07.xcappdata.zip）
  2. 解压得到.xcappdata文件，Mac右键“Show Package Content”。
  3. /App/Data/Documents/目录下保存着上面说的图片和json文件，/App/Library/Preferences/目录下保存着UserDefault对应的plist文件。
  4. xcode连接ipad，点击window->Devices and Simulators，选中iPad和SightReading应用。
  5. 点击下面的齿轮按钮，选择Replace container…，将解压出来的.xcappdata文件替换一下就可以了。

一些其它问题

移动Mask时换页的逻辑

在前一页最后一些节需要显示Mask的时候直接换页到下一页，因为这个时候演奏者已经看完了前一页的最后一小节，并且需要预读下一页的第一小节。

TODOs

  1. 笔记页面不能改变图片大小，比如转屏、全屏等，因为绘制等path坐标没有做相应的更改，会错位。
  2. 笔记页面的橡皮擦功能还不支持。现在的橡皮擦功能实际上就是不同颜色的画笔功能，需要真正实现橡皮擦功能，需要对所有的ATShapeLayer进行修改，添加一个完全透明的橡皮擦的path。
  3. 标签本身不支持编辑功能，比如修改标签名称、删除标签。
  4. 界面只支持英文，需要翻译成中文。
  5. 对于变节拍的乐曲还不支持。如果某些小节拍数会变化，那么节拍器和Mask显示逻辑需要重新考虑。