我们使用简单的开发工具 aardio ，体积只有几 MB，下载打开就可以编程了，不需要任何复杂的配置。
入门示例
使用 aardio 新建一个源码文件：
输入以下代码，点击「运行」按钮合成并播放乐曲：
import sys.midiOut;
//打开播放设备
var midiOut = sys.midiOut();
//播放简谱
midiOut.play("
两只老虎,
1__,2__,3__,1__,
两只老虎,
1__,2__,3__,1__,
跑得快,
3__,4__,5__,__,
跑得快,
3__,4__,5__,__,
一只没有耳朵,
5_,6_,5_,4_,3__,1__,
一只没有尾巴,
5_,6_,5_,4_,3__,1__,
真奇怪,
2__,'5__,1__,__
"); 编程记谱规则
上面的编程记谱法基于简谱记号设计。
所有音符或演奏指令以逗号或换行分开，忽略空格、制表符。
0 表示休止符。
中音使用简谱记号：
"1,2,3,4,5,6,7"高音在后面加单引号( 可加多个，每个单引号增高八度 )：
"1',2',3',4',5',6',7'"低音在音符前面加单引号( 可加多个，每个单引号降低八度 )：
"'1,'2,'3,'4,'5,'6,'7"数字音符前面加 # 高表示升高半个音，示例：
"#1,__,#'5___,#6'___"前面加负号表示消音（停止演奏指定音符），示例：
"-5,-'5"用下划线表示一个延时单位（默认为 250 毫秒 ），前面的音符（或下划线）与后面的下划线可以连起来写，例如：
"5___,5___"可以用双下划线 ? 表示半个下划线表示的延时，例如"5,?,5?"，多个 ? 不允许连着写。
记谱时可以直接调用 midiOut 的成员函数，函数名后必须有括号 () 且必须有参数，例如：
"pitchBend(0.6),1__,2__,3__"pitchBend 函数用于弯音，参数为表示百分比的小数，0 ~ 0.5 为向下弯音，0.5 ~ 1 为向上弯音。更多可用函数请参考库函数文档。
其他数值表示延时，其他字符串表示字幕。
下面是一个小例子：
import sys.midiOut;
var midiOut = sys.midiOut();
//播放简谱
midiOut.play("
1,150,
pitchBend(0.6), 弯音,
500, 延时 500 毫秒,
-1,停（音符前加负号表示消音）
1000
"); 转换简谱为程序代码
我们学习一下怎么翻译简谱，先找个简谱：
4/4 表示以四分音符为一拍，每小节有 4 拍。那么我们用 2 个下划线表示一拍（也就是 500 毫秒 ），那么 上面的
我们翻译为代码：
1__,2__,3__,1__,再看下面的简谱：
这上面的短横线为增时线，表示增加一拍（这里是 500 毫秒，代码里就是增加 2 个下划线 ），所以上面的简谱翻译为代码就是：
3__,4__,5__,__,然后我们再看简谱：
音符下面的横线是减时线，也就是由一拍减为半拍（这里是 250 毫秒，代码里用一个下划线表示），所以上面的简谱翻译为代码就是：
5_,6_,5_,4_,3__,1__,最后生成完整源代码如下：
import sys.midiOut;
//打开播放设备
var midiOut = sys.midiOut();
//播放简谱
midiOut.play("
1__,2__,3__,1__,
1__,2__,3__,1__,
3__,4__,5__,__,
3__,4__,5__,__,
5_,6_,5_,4_,3__,1__,
5_,6_,5_,4_,3__,1__,
2__,'5__,1__,__
"); 要特别注意上面有一个低音 '5，音符前面加个单引号表示低音。
自定义音高、拍子快慢
midiOut.play 函数可选用第 2 个参数指定音符 1 对应的 SPN 音名（ 可用音名在 sys.midiOut.notes 名字空间定义 ），默认值为 "C4"。可选用第 3 个参数指定单个下划线对应的延时单位（默认为 250 毫秒 ）
我们将上面示例的音符 1 改为 "E4" （其他数字音符会自动调整音高），一个延时单位改为 125 毫秒（加快一倍），代码如下：
import sys.midiOut;
//打开播放设备
var midiOut = sys.midiOut();
//播放简谱
midiOut.play("
两只老虎,
1__,2__,3__,1__,
两只老虎,
1__,2__,3__,1__,
跑得快,
3__,4__,5__,__,
跑得快,
3__,4__,5__,__,
一只没有耳朵,
5_,6_,5_,4_,3__,1__,
一只没有尾巴,
5_,6_,5_,4_,3__,1__,
真奇怪,
2__,'5__,1__,__
","E4",125); 请运行一下，听一听有什么区别。
绘制桌面歌词
下面我们再小小改进一下，播放音乐时在桌面上显示漂亮的歌词。
源码如下：
//创建桌面歌词窗口
import win.util.lyric;
var lyric = win.util.lyric();
lyric.show();
//打开播放设备
import sys.midiOut;
var midiOut = sys.midiOut();
//定义显示歌词的函数
midiOut.log = function(str){
lyric.text = str;
}
//播放简谱
midiOut.play("
两只老虎,
1__,2__,3__,1__,
两只老虎,
1__,2__,3__,1__,
跑得快,
3__,4__,5__,__,
跑得快,
3__,4__,5__,__,
一只没有耳朵,
5_,6_,5_,4_,3__,1__,
一只没有尾巴,
5_,6_,5_,4_,3__,1__,
真奇怪,
2__,'5__,1__,__
"); 按「运行」按钮，显示效果如下：
多线程
下面创建独立线程合成并播放音乐，源码：
//合成并输出音乐
import win.util.lyric;
var lyric = win.util.lyric();
lyric.show();
//创建独立线程
thread.invoke( function(lyric){
import sys.midiOut;
var midiOut = sys.midiOut();
//指定字幕回显函数
midiOut.log = function(v) lyric.text = v;
midiOut.play("
两只老虎,
1__,2__,3__,1__,
两只老虎,
1__,2__,3__,1__,
跑得快,
3__,4__,5__,__,
跑得快,
3__,4__,5__,__,
一只没有耳朵,
5_,6_,5_,4_,3__,1__,
一只没有尾巴,
5_,6_,5_,4_,3__,1__,
真奇怪,
2__,'5__,1__,__
");
lyric.close();
},lyric);
win.loopMessage();使用 SPN 音名记谱
编程记谱时可使用 sys.midiOut.notes 名字空间指定的所有音名，这些音名使用科学音高记号（Scientific pitch notation）。
音名与音符的对应关系如下：
音名 | 唱名 | 简谱 |
C4 | do | 1 |
D4 | re | 2 |
E4 | mi | 3 |
F4 | fa | 4 |
G4 | sol | 5 |
A4 | la | 6 |
B4 | ti （si,xi） | 7 |
当然音名与唱名的对应关系可以变更，这里先不用管这些。音名后面的数值越大表示越高的音，例如 C4（ 中央C ，简谱中的 1 ） 高八度就是 C5（ 高音 do，简谱 1 上面加一点），低八度的音就是 C3 （ 低音 do，简谱 1 下面加一点）。
注意：
- SPN 音名中的 -1 省略
- SPN 音名中的升号 ?（Sharp） 用小写 s 替代
例如：C-1? 略写为 Cs 。
示例：
import sys.midiOut;
var midiOut = sys.midiOut();
midiOut.play("
C4,_,_,D4,_,_,E4,_,_,C4,_,_,
C4,_,_,D4,_,_,E4,_,_,C4,_,_,
E4,_,_,F4,_,_,G4,_,_,_,_,
E4,_,_,F4,_,_,G4,_,_,_,_,
G4,_,A4,_,G4,_,F4,_,E4,_,_,C4,_,_,
G4,_,A4,_,G4,_,F4,_,E4,_,_,C4,_,_,
D4,_,_,G3,_, _,C4,
1000
"); 也可以这样写：
import sys.midiOut;
//打开音名空间
namespace sys.midiOut.notes{
//记谱（这里下划线与音符不能连起来，也不能使用数字音符）
drm = {
"两只老虎",
C4,_,_,D4,_,_,E4,_,_,C4,_,_,
"两只老虎",
C4,_,_,D4,_,_,E4,_,_,C4,_,_,
"跑得快",
E4,_,_,F4,_,_,G4,_,_,_,_,
"跑得快",
E4,_,_,F4,_,_,G4,_,_,_,_,
"一只没有耳朵",
G4,_,A4,_,G4,_,F4,_,E4,_,_,C4,_,_,
"一只没有尾巴",
G4,_,A4,_,G4,_,F4,_,E4,_,_,C4,_,_,
"真奇怪",
D4,_,_,G3,_, _,C4,
//用下面的方式调用函数，小于等于 127 的延时必须调用 delay 函数
{"delay",1000}
}
}
var midiOut = sys.midiOut();
midiOut.play( sys.midiOut.notes.drm ); 切换乐器
我们还可以选择不同的乐器，代码示例：
import sys.midiOut;
var midiOut = sys.midiOut();
//选择八音盒，参数为乐器编号
midiOut.changeInstrument(10);在谱子中也可以切换乐器，例如：
import sys.midiOut;
var midiOut = sys.midiOut();
midiOut.play( "
changeInstrument(10),
1___,
2___,
3___,
" );
可用的乐器编号为 0~127 范围的数值，全部编号如下：
//钢琴
0 大钢琴（声学钢琴）
1 明亮的钢琴
2 电钢琴
3 酒吧钢琴
4 柔和的电钢琴
5 加合唱效果的电钢琴
6 羽管键琴（拨弦古钢琴）
7 科拉维科特琴（击弦古钢琴）
//色彩打击乐器
8 钢片琴
9 钟琴
10 八音盒
11 颤音琴
12 马林巴
13 木琴
14 管钟
15 大扬琴
//风琴
16 击杆风琴
17 打击式风琴
18 摇滚风琴
19 教堂风琴
20 簧管风琴
21 手风琴
22 口琴
23 探戈手风琴
//吉他
24 尼龙弦吉他
25 钢弦吉他
26 爵士电吉他
27 清音电吉他
28 闷音电吉他
29 加驱动效果的电吉他
30 加失真效果的电吉他
31 吉他和音
//贝司
32 大贝司（声学贝司）
33 电贝司（指弹）
34 电贝司（拨片）
35 无品贝司
36 掌击1
37 掌击2
38 电子合成1
39 电子合成2
//弦乐
40 小提琴
41 中提琴
42 大提琴
43 低音大提琴
44 弦乐群颤音音色
45 弦乐群拨弦音色
46 竖琴
47 定音鼓
//合奏/合唱
48 弦乐合奏音色1
49 弦乐合奏音色2
50 合成弦乐合奏音色1
51 合成弦乐合奏音色2
52 人声合唱“啊”
53 人声“嘟”
54 合成人声
55 管弦乐敲击齐奏
//铜管
56 小号
57 长号
58 大号
59 加弱音器小号
60 法国号（圆号）
61 铜管组（铜管乐器合奏音色）
62 合成铜管音色1
63 合成铜管音色2
//簧管
64 高音萨克斯风
65 次中音萨克斯风
66 中音萨克斯风
67 低音萨克斯风
68 双簧管
69 英国管
70 巴松（大管）
71 单簧管（黑管）
//笛
72 短笛
73 长笛
74 竖笛
75 排箫
76 Bottle Blow
77 日本尺八
78 口哨声
79 奥卡雷那
//合成主音
80 合成主音1（方波）
81 合成主音2（锯齿波）
82 合成主音3
83 合成主音4
84 合成主音5
85 合成主音6（人声）
86 合成主音7（平行五度）
87 +合成主音8（贝司加主音）
//合成音色
88 合成音色1（新世纪）
89 合成音色2（温暖）
90 合成音色3
91 合成音色4（合唱）
92 合成音色5
93 合成音色6（金属声）
94 合成音色7（光环）
95 合成音色8
//合成效果
96 雨声
97 音轨
98 水晶
99 大气
100 明亮
101 鬼怪
102 回声
103 科幻
//民间乐器
104 西塔尔（印度）
105 班卓琴（美洲）
106 三昧线（日本）
107 十三弦筝（日本）
108 卡林巴
109 风笛
110 民族提琴
111 山奈
//打击乐器
112 叮当铃
113 Agogo 钟
114 钢鼓
115 木鱼
116 太鼓
117 通通鼓
118 合成鼓
119 铜钹
//声音效果
120 吉他换把杂音
121 呼吸声
122 海浪声
123 鸟鸣
124 电话铃
125 直升机
126 鼓掌声
127 Q 声