Sonido

Introducción

Los sonidos del robot codificador VEX AIM permiten a los usuarios reproducir sonidos incorporados, archivos de audio personalizados y notas musicales. También incluye controles para detener los sonidos y detectar si el audio se está reproduciendo actualmente.

A continuación se muestra una lista de todos los métodos:

Acciones: reproducir o detener sonidos.

• play — Reproduce un efecto de sonido incorporado.

• play_file — Reproduce un sonido personalizado cargado por el usuario.

• play_note — Reproduce una nota musical durante un tiempo determinado.

• stop — Detiene cualquier sonido que se esté reproduciendo actualmente.

Getter — Compruebe el estado del sonido.

• is_active — Devuelve si un sonido se está reproduciendo actualmente.

Acciones

play

play reproduce uno de los sonidos incorporados del robot en un porcentaje de volumen especificado. Dado que este es un método de no espera, el robot reproduce el sonido incorporado y pasa al siguiente comando sin esperar a que termine.

Uso:

robot.sound.play(sound, volume)

Parámetro	Descripción
sound	Una de las opciones de sonido integradas que se enumeran a continuación.
volume	Opcional. El volumen para el sonido, como un número entero del 0% al 100%. El valor predeterminado es 50%.

Sonidos integrados	Reproducir sonido
ACT_ANGRY	Jugar
ACT_EXCITED	Jugar
ACT_HAPPY	Jugar
ACT_SAD	Jugar
ACT_SILLY	Jugar
BLINKER	Jugar
BRAKES	Jugar
CHEER	Jugar
CHIRP	Jugar
COMPLETE	Jugar
CRASH	Jugar
DETECTED	Jugar
DOORBELL	Jugar
FAIL	Jugar
FLOURISH	Jugar
HUAH	Jugar
LOOPING	Jugar
MOVE_FORWARD	Jugar
MOVE_REVERSE	Jugar
OBSTACLE	Jugar
PAUSE	Jugar
PICKUP	Jugar
RECEIVE	Jugar
RESUME	Jugar
SENSING	Jugar
SEND	Jugar
SPARKLE	Jugar
TADA	Jugar
TURN_LEFT	Jugar
TURN_RIGHT	Jugar

# 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 reproduce un sonido personalizado subido por el usuario. Dado que este es un método de no espera, el robot reproduce el sonido personalizado y pasa al siguiente comando sin esperar a que termine.

Uso:

robot.sound.play_file(file, volume)

Parámetro	Descripción
file	Uno de los archivos de sonido personalizados cargados por el usuario, de SOUND1 a SOUND10. El número de sonido coincide con el número que se muestra en el panel de control de AIM.
volume	Opcional. El volumen para el sonido, como un número entero del 0% al 100%. El valor predeterminado es 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 reproduce una nota específica durante una duración específica en milisegundos. Dado que este es un método de no espera, el robot toca la nota específica y pasa al siguiente comando sin esperar a que termine.

Uso:

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

Parámetro	Descripción
note	El tono musical a tocar, escrito como una cuerda (por ejemplo, C5, A#6). Las notas válidas son de la A a la G (con # para objetos punzantes) en las octavas 5 a 8.
length	La duración de la nota, dada como un número entero en milisegundos.
volume	Opcional. El volumen para el sonido, como un número entero del 0% al 100%. El valor predeterminado es 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 detiene un sonido que se está reproduciendo actualmente.

Uso:

robot.sound.stop()

Parámetros	Descripción
	Este método no tiene parámetros.

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

Getters

is_active

is_active devuelve un booleano que indica si un sonido se está reproduciendo actualmente.

• True : un sonido se está reproduciendo

• False : no se está reproduciendo ningún sonido

Uso:

robot.sound.is_active()

Parámetros	Descripción
	Este método no tiene parámetros.

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