Note(音符) API

Note(音符) API提供了将音符转换为它们各自的MIDI编码和/或频率(单位为赫兹)的功能,以及一些其他功能。此API常与computer.beep以及原版的音符盒(需安装OpenComponents模组)配合使用。

  • note.midi(n: number or string): number
    将字符串格式的音符(如 A#4 或 Gb3,查看下表)或给出的频率转换为MIDI编码。

  • note.freq(n: number or string): number
    将字符串格式的音符(如 A#4)或给出的MIDI编码转换为频率。

  • note.name(n: number): string
    将MIDI编码转换回字符串。如果你需要转换频率,请用note.name(note.midi(frequency))

  • note.ticks(n: number): number
    将音符盒的音高(0-24)转换为MIDI编码(分别对应34-58),或者反过来。在与音符盒以及OpenComponents配合使用时很有帮助。

  • note.play(tone: string or number,duration: number)
    通过computer.beep演奏字符串或MIDI编码对应的音符,时长为duration参数。

可用音符

可用的字符串名称、它们对应的MIDI编码和频率如下表所示:

名称MIDI编码频率
A02127.5000
A#0/Bb02229.1352
B02330.8677
C12432.7032
C#1/Db12534.6478
D12636.7081
D#1/Eb12738.8909
E12841.2034
F12943.6535
F#1/Gb13046.2493
G13148.9994
G#1/Ab13251.9131
A13355.0000
A#1/Bb13458.2705
B13561.7354
C23665.4064
C#2/Db23769.2957
D23873.4162
D#2/Eb23977.7817
E24082.4069
F24187.3071
F#2/Gb24292.4986
G24397.9989
G#2/Ab244103.826
A245110.000
A#2/Bb246116.541
B247123.471
C348130.813
C#3/Db349138.591
D350146.832
D#3/Eb351155.563
E352164.814
F353174.614
F#3/Gb354184.997
G355195.998
G#3/Ab356207.652
A357220.000
A#3/Bb358233.082
B359246.942
C460261.626
C#4/Db461277.183
D462293.665
D#4/Eb463311.127
E464329.628
F465349.228
F#4/Gb466369.994
G467391.995
G#4/Ab468415.305
A469440.000
A#4/Bb470466.164
B471493.883
C572523.251
C#5/Db573554.365
D574587.330
D#5/Eb575622.254
E576659.255
F577698.456
F#5/Gb578739.989
G579783.991
G#5/Ab580830.609
A581880.000
A#5/Bb582932.328
B583987.767
C6841046.50
C#6/Db6851108.73
D6861174.66
D#6/Eb6871244.51
E6881318.51
F6891396.91
F#6/Gb6901479.98
G6911567.98
G#6/Ab6921661.22
A6931760.00
A#6/Bb6941864.66
B6951975.53

目录