Geluid

Invoering

De VEX AIM Coding Robot beschikt over diverse geluidsfuncties, waarmee gebruikers ingebouwde geluiden, eigen audiobestanden en muzieknoten kunnen afspelen. Ook zijn er bedieningsknoppen om geluiden te stoppen en te controleren of er momenteel audio wordt afgespeeld.

Hieronder vindt u een lijst met alle methoden:

Acties — Geluiden afspelen of stoppen.

• play — Speelt een ingebouwd geluidseffect af.

• play_file — Speelt een door de gebruiker geüpload aangepast geluid af.

• play_note — Speelt een muzieknoot gedurende een bepaalde tijd.

• stop — Stopt elk geluid dat momenteel wordt afgespeeld.

Getter — Controleer de geluidsstatus.

• is_active — Geeft aan of er momenteel een geluid wordt afgespeeld.

Acties

play

play af: hiermee wordt een van de ingebouwde geluiden van de robot afgespeeld met een bepaald volumepercentage. Omdat dit een methode zonder wachttijd is, speelt de robot het ingebouwde geluid af en gaat hij direct door naar de volgende opdracht, zonder te wachten tot deze is voltooid.

Gebruik:

robot.sound.play(sound, volume)

Parameter	Beschrijving
sound	Een van de ingebouwde geluidsopties die hieronder worden vermeld.
volume	Optioneel. Het volume van het geluid, als een geheel getal van 0% tot 100%. De standaardwaarde is 50%.

Ingebouwde geluiden	Geluid afspelen
ACT_ANGRY	Afspelen
ACT_EXCITED	Afspelen
ACT_HAPPY	Afspelen
ACT_SAD	Afspelen
ACT_SILLY	Afspelen
BLINKER	Afspelen
BRAKES	Afspelen
CHEER	Afspelen
CHIRP	Afspelen
COMPLETE	Afspelen
CRASH	Afspelen
DETECTED	Afspelen
DOORBELL	Afspelen
FAIL	Afspelen
FLOURISH	Afspelen
HUAH	Afspelen
LOOPING	Afspelen
MOVE_FORWARD	Afspelen
MOVE_REVERSE	Afspelen
OBSTACLE	Afspelen
PAUSE	Afspelen
PICKUP	Afspelen
RECEIVE	Afspelen
RESUME	Afspelen
SENSING	Afspelen
SEND	Afspelen
SPARKLE	Afspelen
TADA	Afspelen
TURN_LEFT	Afspelen
TURN_RIGHT	Afspelen

# 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 speelt een aangepast geluid af dat door de gebruiker is geüpload. Omdat dit een methode zonder wachttijd is, speelt de robot het aangepaste geluid af en gaat hij door naar de volgende opdracht zonder te wachten tot deze is voltooid.

Gebruik:

robot.sound.play_file(file, volume)

Parameter	Beschrijving
file	Een van de door de gebruiker geüploade aangepaste geluidsbestanden, van SOUND1 tot SOUND10Het geluidsnummer komt overeen met het nummer dat wordt weergegeven in het AIM-configuratiescherm.
volume	Optioneel. Het volume van het geluid, als een geheel getal van 0% tot 100%. De standaardwaarde is 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 speelt een specifieke noot gedurende een bepaalde tijd in milliseconden. Omdat dit een methode zonder wachttijd is, speelt de robot de specifieke noot en gaat hij door naar de volgende opdracht zonder te wachten tot deze is voltooid.

Gebruik:

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

Parameter	Beschrijving
note	De te spelen toonhoogte, weergegeven als een snaar (bijv. C5, A#6). Geldige noten zijn A tot en met G (met optioneel # voor kruizen) over de octaven 5 tot en met 8.
length	De duur van de noot, weergegeven als een geheel getal in milliseconden.
volume	Optioneel. Het volume van het geluid, als een geheel getal van 0% tot 100%. De standaardwaarde is 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 stopt een geluid dat momenteel wordt afgespeeld.

Gebruik:

robot.sound.stop()

Parameters	Beschrijving
	Deze methode heeft geen parameters.

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

Getters

is_active

is_active retourneert een Booleaanse waarde die aangeeft of er momenteel een geluid wordt afgespeeld.

• True — Er wordt momenteel een geluid afgespeeld

• False — Er wordt geen geluid afgespeeld

Gebruik:

robot.sound.is_active()

Parameters	Beschrijving
	Deze methode heeft geen parameters.

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