Document

播放音乐

开始学习前需了解：板子提供了一个 midi 播放功能模块，它可以对指定的蜂鸣器进行 PWM 输出，从而播放出音乐

使用代码如下（接口可参考 Microbit 文档）

import music
music.play(music.NYAN)

可以看到有如下列表，这都是内置的音乐

music.DADADADUM
music.ENTERTAINER
music.PRELUDE
music.ODE
music.NYAN
music.RINGTONE
music.FUNK
music.BLUES
music.BIRTHDAY
music.WEDDING
music.FUNERAL
music.PUNCHLINE
music.PYTHON
music.BADDY
music.CHASE
music.BA_DING
music.WAWAWAWAA
music.JUMP_UP
music.JUMP_DOWN
music.POWER_UP
music.POWER_DOWN

创建一首你自己的曲子

写下一段 Python 的列表 ["C4:4", "D4", "C", "E:8"]，就代表一段音乐。

这段代码可以认为每一个元素都是一个音符，它的格式满足如下：

NOTE[octave][:duration]

首先要有一丁点的乐理基本理解。

NOTE 指这一节点的音阶，通俗来讲，音乐里的 C D E F G A B 就是音阶，如 "C" 指 do，所以 C D E F G A B 就是 do re mi fa so la xi

octave 指这一节点的八度，八度就是指音程关系，简单一点讲，就是你唱 1 2 3 4 5 6 7 1 （注释：1234567 对应的音名分别是CDEFGAB），第一个 1 就是最后一个 1 的低八度，最后一个1就是第一个1的高八度，低音到高音，越小就越低音

duration 指这一节点的拍子数，简单理解为该节点音符播放持续的时间

举例来说：

"C4:4" 相当于 C（Do）在 4 （中音部分）的音符，接着 :4 指持续四个拍子，默认的拍子时长是 125 ms，即播放时长（duration）为 0.5 s

案例：基础测试

import music
music.play([ "C4", "D4", "E4", "F4", "G4", "A4", "B4", "C5"])
music.play([ "D1", "D2", "D3", "D4", "D5", "D6", "D7", "D8"])

案例：二只老虎

为了能够在板子上播放这首经典的两只老虎，准备了如下代码。

import music

tune = ["C4:4", "D4:4", "E4:4", "C4:4", "C4:4", "D4:4", "E4:4", "C4:4",
        "E4:4", "F4:4", "G4:8", "E4:4", "F4:4", "G4:8"]
music.play(tune)

它还可以进一步简化作曲过程，比如说，现在的节点 'C4:4' 将会影响到之后的八度配置，直到有新的替换。
所你可以这样写：

import music

tune = ["C4:4", "D", "E", "C", "C", "D", "E", "C", "E", "F", "G:8",
        "E:4", "F", "G:8"]
music.play(tune)

声音效果

music 让你制作非音符的声音，比如下面这里就创建了一个警笛声

from microbit import *
import music
while True:
    music.pitch(range(880, 1760, 16), 15)
    sleep(50)
    music.pitch(range(1760, 880, -16), 15)
    sleep(50)

注意 : music.pitch 方法是使用它的实例，它需要一个频率，15 的频率相当于一场用来调音的音乐会的频率

另外，在这个案例中，range 函数是被用作生成一个数字的值，这些数字定义了音调的音高，这三个参数分别分开始值，结束值，以及梯度值。因此，这里第一个 range 的意思是。创造一个频率值从 880 开始，以 16 的跨度递增到 1760 ，而至于第二个 range 是说创造一个1760 以 16 的跨度来递减到 880 。这就使得我们可以发出一上一下像警笛一样的声音

最后使用了 while Ture： 它会让这个警笛声一直持续下去的

获取乐谱

第一次接触这种音乐的格式不懂乐理的同学可能就有点懵了。那有没有一种可以快速获取乐谱的方法呢？有网友专门制作了一个转换工具，可以自动生成音频格式的数据。那就让我们来试试用这个工具生成板子可以播放的音乐数据吧。
这个工具由 fizban99 制作。 https://github.com/fizban99/microbit_rttl
转换的工作是一个excel的文件来实现的，首先下载这个excel文件，点击下载
有了转换的工具了，接下来就需要下载音乐源文件了,点击下面连接进行下载
Zip file of Mixed Tunes 1 (450 tunes)
Zip file of Mixed Tunes 2 (375 tunes)
Zip file of Mixed Tunes 3 (10,000 tunes)
Zip file of TV Theme Tunes (50 tunes)
Zip file of Christmas Tunes (70 tunes)
把下载的音乐源文件都解压，所有准备工作做好之后，打开我们之前下载的excel文件，你会见到像下面的界面

1.png

点击Open RTTTL tune file ，它会自动弹出文件管理器，找到我们刚才解压的文件中的其中一个，选中要转换的音乐文件后，点击打开

完成上面的步骤后就完成了转换的工作，点击 play 可以播放音乐文件，注意：这里的 Copy code 是使用不了的，复制出来的是乱码，所以直接复制红框中的内容

复制转换出来的代码,就可以让板子播放音乐了

import music
music.set_tempo(ticks=16, bpm=45)
tune = ['D#6', 'D#', 'D#:2', 'F', 'G', 'G#', 'G#', 'G', 'F', 'F:6',
        'D:2', 'D', 'D', 'D', 'D#','F', 'G', 'G', 'F', 'D#', 'D#:6',
        'D#:2', 'D#', 'D#', 'D#', 'F', 'G', 'G#', 'G#', 'G', 'F', 'F:4']
music.play(tune)

Mircopython：在BPIbit上播放音乐