Ljud

Introduktion

VEX AIM-kodningsrobotens ljud låter användare spela inbyggda ljud, anpassade ljudfiler och musiknoter. Den innehåller också kontroller för att stoppa ljud och upptäcka om ljud spelas upp.

Nedan följer en lista över alla metoder:

Åtgärder — Spela upp eller stoppa ljud.

• play — Spelar upp en inbyggd ljudeffekt.

• play_file — Spelar upp ett användaruppladdat anpassat ljud.

• play_note — Spelar en musiknot under en viss tid.

• stop — Stoppar alla ljud som spelas upp.

Getter — Kontrollera ljudstatus.

• is_active — Returnerar om ett ljud spelas upp för närvarande.

Åtgärder

play

play spelar upp ett av robotens inbyggda ljud med en specificerad volymprocent. Eftersom detta är en metod utan väntetid spelar roboten upp det inbyggda ljudet och går vidare till nästa kommando utan att vänta på att det ska slutföras.

Användande:

robot.sound.play(sound, volume)

Parameter	Beskrivning
sound	Ett av de inbyggda ljudalternativen som listas nedan.
volume	Valfritt. Volymen för ljudet, som ett heltal från 0 % till 100 %. Standardinställningen är 50 %.

Inbyggda ljud	Spela upp ljud
ACT_ANGRY	Spela
ACT_EXCITED	Spela
ACT_HAPPY	Spela
ACT_SAD	Spela
ACT_SILLY	Spela
BLINKER	Spela
BRAKES	Spela
CHEER	Spela
CHIRP	Spela
COMPLETE	Spela
CRASH	Spela
DETECTED	Spela
DOORBELL	Spela
FAIL	Spela
FLOURISH	Spela
HUAH	Spela
LOOPING	Spela
MOVE_FORWARD	Spela
MOVE_REVERSE	Spela
OBSTACLE	Spela
PAUSE	Spela
PICKUP	Spela
RECEIVE	Spela
RESUME	Spela
SENSING	Spela
SEND	Spela
SPARKLE	Spela
TADA	Spela
TURN_LEFT	Spela
TURN_RIGHT	Spela

# 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 spelar upp ett anpassat ljud som laddats upp av användaren. Eftersom detta är en metod utan väntetid spelar roboten upp det anpassade ljudet och går vidare till nästa kommando utan att vänta på att det ska slutföras.

Användande:

robot.sound.play_file(file, volume)

Parameter	Beskrivning
file	En av de anpassade ljudfiler som laddats upp av användaren, från SOUND1 till SOUND10Ljudnumret matchar numret som visas i AIM-kontrollpanelen.
volume	Valfritt. Volymen för ljudet, som ett heltal från 0 % till 100 %. Standardinställningen är 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 spelar en specifik ton under en specifik tid i millisekunder. Eftersom detta är en metod utan väntetid spelar roboten den specifika tonen och går vidare till nästa kommando utan att vänta på att det ska slutföras.

Användande:

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

Parameter	Beskrivning
note	Den musikaliska tonhöjden som ska spelas, skriven som en sträng (t.ex. C5, A#6). Giltiga toner är A till G (med valfritt # för kors) över oktaver 5 till 8.
length	Notens längd, angiven som ett heltal i millisekunder.
volume	Valfritt. Volymen för ljudet, som ett heltal från 0 % till 100 %. Standardinställningen är 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 stoppar ett ljud som spelas upp.

Användande:

robot.sound.stop()

Parametrar	Beskrivning
	Den här metoden har inga parametrar.

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

Getters

is_active

is_active returnerar ett booleskt värde som anger om ett ljud spelas upp för närvarande.

• True — Ett ljud spelas upp just nu

• False — Inget ljud spelas upp

Användande:

robot.sound.is_active()

Parametrar	Beskrivning
	Den här metoden har inga parametrar.

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