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

sound

Una de las opciones de sonido integradas que se enumeran a continuación.

volume

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

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 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

file

Uno de los archivos de sonido personalizados cargados por el usuario, desde SOUND1 hasta SOUND10El número de sonido coincide con el número que se muestra en el panel de control de AIM.

volume

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

note

La altura musical a tocar, escrita como una cadena (por ejemplo, C5, A#6). Las notas válidas son A a G (con # opcional para sostenidos) en las octavas 5 a 8.

length

La duración de la nota, expresada como un número entero en milisegundos.

volume

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 sonido

  • 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)