声音

介绍

VEX AIM 编程机器人的声音功能允许用户播放内置声音、自定义音频文件和音符。它还包含用于停止声音和检测音频是否正在播放的控件。以下是所有可用方法的列表：

动作——播放或停止声音。

• play – Plays a built-in sound effect.

• play_file – Plays a user-uploaded custom sound.

• play_note – Plays a musical note for a set duration.

• stop – Stops any currently playing sound.

Getter – 检查声音状态。

• is_active – Returns whether a sound is currently playing.

行动

play

play plays one of the robot’s built-in sounds at a specified volume percentage. Since this is a non-waiting method, the robot plays the built-in sound and moves to the next command without waiting for it to finish.

用法：

robot.sound.play(sound, volume)

范围	描述
sound	下面列出的内置声音选项之一。
volume	可选。声音的音量，以 0% 到 100% 之间的整数表示。默认值为 50%。

内置声音	播放声音
ACT_ANGRY	播放
ACT_EXCITED	播放
ACT_HAPPY	播放
ACT_SAD	播放
ACT_SILLY	播放
BLINKER	播放
BRAKES	播放
CHEER	播放
CHIRP	播放
COMPLETE	播放
CRASH	播放
DETECTED	播放
DOORBELL	播放
FAIL	播放
FLOURISH	播放
HUAH	播放
LOOPING	播放
MOVE_FORWARD	播放
MOVE_REVERSE	播放
OBSTACLE	播放
PAUSE	播放
PICKUP	播放
RECEIVE	播放
RESUME	播放
SENSING	播放
SEND	播放
SPARKLE	播放
TADA	播放
TURN_LEFT	播放
TURN_RIGHT	播放

# Play cheer
robot.sound.play(CHEER)

# Play cheer at full volume
robot.sound.play(CHEER, 100)

# Wait until sound is finished to move
robot.sound.play(ACT_HAPPY)
while robot.sound.is_active():
    wait(50, MSEC)
robot.turn_to(180)

play_file

play_file plays a custom sound uploaded by the user. Since this is a non-waiting method, the robot plays the custom sound and moves to the next command without waiting for it to finish.

用法：

robot.sound.play_file(file, volume)

范围	描述
file	One of the custom sound files uploaded by the user, from SOUND1 to SOUND10. The sound number matches the number shown in the AIM control panel.
volume	可选。声音的音量，以 0% 到 100% 之间的整数表示。默认值为 50%。

# Play an uploaded sound
robot.sound.play_file(SOUND1)

# Play an uploaded sound at full volume
robot.sound.play_file(SOUND1, 100)

# Wait until sound is finished to move
robot.sound.play_file(SOUND1)
while robot.sound.is_active():
    wait(50, MSEC)
robot.turn_to(180)

play_note

play_note plays a specific note for a specific duration in milliseconds. Since this is a non-waiting method, the robot plays the specific note and moves to the next command without waiting for it to finish.

用法：

robot.sound.play_note(note, length, volume)

范围	描述
note	The musical pitch to play, written as a string (e.g., C5, A#6). Valid notes are A through G (with optional # for sharps) across octaves 5 to 8.
length	音符的持续时间，以毫秒为单位的整数表示。
volume	可选。音符的音量，取值范围为 0% 到 100% 之间的整数。默认值为 50%。

# Play C5 for 2 seconds
robot.sound.play_note("C5", 2000)

# Play C5 for 2 seconds at full volume
robot.sound.play_note("C5", 2000, 100)

# Wait until note is finished to move
robot.sound.play_note("C6", 1000)
while robot.sound.is_active():
    wait(50, MSEC)
robot.turn_to(180)

stop

stop stops a sound that is currently playing.

用法：

robot.sound.stop()

参数	描述
	该方法没有参数。

# Cut a sound off after 1 second
robot.sound.play(ACT_SILLY)
wait(1, SECONDS)
robot.sound.stop()

吸气剂

is_active

is_active returns a Boolean indicating whether a sound is currently playing.

• True – A sound is currently playing

• False – No sound is playing

用法：

robot.sound.is_active()

参数	描述
	该方法没有参数。

# Play tada after cheer finishes
robot.sound.play(CHEER)   
while robot.sound.is_active():
    wait(10, MSEC)
robot.sound.play(TADA)