脑#
初始化 Brain 类#
要在您的项目中使用 EXP Brain,请首先按如下方式初始化它:
# Create a new object "brain" with the Brain class.
brain = Brain()
当引用 Brain 类方法和属性时,此“brain”对象将在整个 API 文档的所有后续示例中使用。
Brain 类具有六个预定义属性:
battery
- 提供有关 EXP Brain 电池的信息,包括容量、温度、电压和电流。button
- 允许您检测按钮按下并为 EXP Brain 上的按钮事件分配功能。timer
- 提供测量经过时间的功能并为 EXP Brain 上基于时间的事件分配函数。screen
- 使您能够在 EXP Brain 的屏幕上显示文本和绘制图像。sdcard
- 提供对存储在 EXP Brain 的 SD 卡上的文件的访问。three_wire_port
- 提供对连接到 EXP Brain 的 3 线端口的 3 线传感器的访问。每个端口由一个字母(a 到 h)标识,可以使用brain.three_wire_port.x
格式访问,其中x
是端口字母。例如,brain.three_wire_port.a
指的是连接到端口 A 的传感器。
类方法#
除了属性之外,Brain 类还提供了几种可以直接使用的方法。
播放声音()#
brain.play_sound(sound,volume)
命令在 Brain 上播放声音。
参数 |
描述 |
---|---|
声音 |
有效的 SoundType。 |
体积 |
**可选。**音量,最大为 100。 |
**返回:**无。
# Play a sound of type TADA.
brain.play_sound(SoundType.TADA)
播放音符()#
brain.play_note(octave, note, duration,volume)
命令在 Brain 上播放一个音符。
参数 |
描述 |
---|---|
八度 |
要使用的八度。 |
笔记 |
要播放的音符。 |
期间 |
**可选。**播放音符的持续时间(以毫秒为单位)。 |
体积 |
**可选。**音量。最大值为 100。 |
**返回:**无。
# Play a note on the Brain.
brain.play_note(1, 4, 200, 50)
播放文件()#
brain.play_file(filename,volume)
命令在 Brain 上播放 .wav 格式的声音文件。
参数 |
描述 |
---|---|
文件名 |
要播放的声音文件。 |
体积 |
**可选。**音量,最大为 100。 |
**返回:**无。
# Play the sound file titled "myfile.wav" on the Brain.
brain.play_file('myfile.wav', 50)
声音关闭()#
brain.sound_off()
命令停止正在播放的任何声音。
**返回:**无。
# Turn off the sound on the Brain.
brain.sound_off()
声音处于活动状态()#
brain.sound_is_active()
命令检查声音是否正在播放。
返回: 如果声音正在播放,则返回 True
。如果声音未播放,则返回 False
。
声音持续时间()#
brain.sound_duration()
命令获取当前播放的声音的总持续时间。
**返回:**以毫秒为单位的持续时间。
剩余声音()#
brain.sound_remaining()
命令获取当前播放声音的剩余时长。
**返回:**以毫秒为单位的持续时间。