Sonido#
Introducción#
El robot de programación VEX AIM permite a los usuarios reproducir sonidos integrados, archivos de audio personalizados y notas musicales. Además, incluye controles para detener la reproducción de sonidos y detectar si se está reproduciendo algún audio.
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 subido por el usuario.play_note— Reproduce una nota musical durante una duración determinada.stop— Detiene cualquier sonido que se esté reproduciendo actualmente.
Obtener: comprobar el estado del sonido.
is_active— Devuelve si un sonido se está reproduciendo actualmente.
Comportamiento#
play#
El comando play reproduce uno de los sonidos integrados del robot a un porcentaje de volumen específico. Dado que este método no requiere espera, el robot reproduce el sonido integrado y pasa al siguiente comando sin esperar a que finalice.
Uso:
robot.sound.play(sound, volume)
Parámetro |
Descripción |
|---|---|
|
Una de las opciones de sonido integradas que se enumeran a continuación. |
|
Opcional. El volumen del sonido, expresado como un número entero del 0% al 100%. El valor predeterminado es el 50%. |
Sonidos incorporados |
Reproducir sonido |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# 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. Como este es un método sin 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 |
|---|---|
|
Uno de los archivos de sonido personalizados cargados por el usuario, desde |
|
Opcional. El volumen del sonido, expresado como un número entero del 0% al 100%. El valor predeterminado es el 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 determinada en milisegundos. Dado que este método no requiere espera, el robot reproduce la nota específica y pasa al siguiente comando sin esperar a que finalice.
Uso:
robot.sound.play_note(note, length, volume)
Parámetro |
Descripción |
|---|---|
|
La altura musical a tocar, escrita como una cadena (por ejemplo, |
|
La duración de la nota, expresada como un número entero en milisegundos. |
|
Opcional. El volumen del sonido, expresado como un número entero del 0% al 100%. El valor predeterminado es el 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()
Captadores#
is_active#
is_active devuelve un valor booleano que indica si se está reproduciendo un sonido en ese momento.
True— Actualmente se está reproduciendo un sonidoFalse— 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)