#

初始化 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() 命令获取当前播放声音的剩余时长。

**返回:**以毫秒为单位的持续时间。