Ääni

Johdanto

VEX AIM -koodausrobotin äänien avulla käyttäjät voivat toistaa sisäänrakennettuja ääniä, mukautettuja äänitiedostoja ja nuotteja. Se sisältää myös säätimet äänien pysäyttämiseen ja äänen toiston havaitsemiseen.

Alla on luettelo kaikista menetelmistä:

Toiminnot — Toista tai pysäytä äänet.

• play — Toistaa sisäänrakennetun äänitehosteen.

• play_file — Toistaa käyttäjän lataaman mukautetun äänen.

• play_note — Soittaa nuotin asetetun ajan.

• stop — Pysäyttää parhaillaan toistettavan äänen.

Getter — Tarkista äänen tila.

• is_active — Palauttaa, toistetaanko ääntä parhaillaan.

Toiminnot

play

play toistaa yhden robotin sisäänrakennetuista äänistä tietyllä äänenvoimakkuusprosentilla. Koska tämä on odotuskelvoton menetelmä, robotti toistaa sisäänrakennetun äänen ja siirtyy seuraavaan komentoon odottamatta sen päättymistä.

Käyttö:

robot.sound.play(sound, volume)

Parametri	Kuvaus
sound	Yksi alla luetelluista sisäänrakennetuista ääniasetuksista.
volume	Valinnainen. Äänenvoimakkuus kokonaislukuna 0–100 %. Oletusarvo on 50 %.

Sisäänrakennetut äänet	Toista ääni
ACT_ANGRY	Toista
ACT_EXCITED	Toista
ACT_HAPPY	Toista
ACT_SAD	Toista
ACT_SILLY	Toista
BLINKER	Toista
BRAKES	Toista
CHEER	Toista
CHIRP	Toista
COMPLETE	Toista
CRASH	Toista
DETECTED	Toista
DOORBELL	Toista
FAIL	Toista
FLOURISH	Toista
HUAH	Toista
LOOPING	Toista
MOVE_FORWARD	Toista
MOVE_REVERSE	Toista
OBSTACLE	Toista
PAUSE	Toista
PICKUP	Toista
RECEIVE	Toista
RESUME	Toista
SENSING	Toista
SEND	Toista
SPARKLE	Toista
TADA	Toista
TURN_LEFT	Toista
TURN_RIGHT	Toista

# 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 toistaa käyttäjän lataaman mukautetun äänen. Koska tämä on odotuskelvoton menetelmä, robotti toistaa mukautetun äänen ja siirtyy seuraavaan komentoon odottamatta sen valmistumista.

Käyttö:

robot.sound.play_file(file, volume)

Parametri	Kuvaus
file	Yksi käyttäjän lataamista mukautetuista äänitiedostoista väliltä SOUND1 - SOUND10Äänen numero vastaa AIM-ohjauspaneelissa näkyvää numeroa.
volume	Valinnainen. Äänenvoimakkuus kokonaislukuna 0–100 %. Oletusarvo on 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 soittaa tietyn nuotin tietyn millisekunteina mitatun ajan. Koska tämä on odotuskelvoton menetelmä, robotti soittaa tietyn nuotin ja siirtyy seuraavaan komentoon odottamatta sen päättymistä.

Käyttö:

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

Parametri	Kuvaus
note	Soitettava sävelkorkeus merkkijonona kirjoitettuna (esim. C5, A#6). Kelvollisia nuotteja ovat A - G (valinnainen # teräville sävelille) oktaavien 5 ja 8 välillä.
length	Nuotin kesto millisekunteina kokonaislukuna.
volume	Valinnainen. Äänenvoimakkuus kokonaislukuna 0–100 %. Oletusarvo on 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 pysäyttää parhaillaan toistettavan äänen.

Käyttö:

robot.sound.stop()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

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

Getterit

is_active

is_active palauttaa totuusarvon, joka ilmaisee, toistetaanko ääntä parhaillaan.

• True — Ääntä toistetaan parhaillaan

• False — Ääntä ei toisteta

Käyttö:

robot.sound.is_active()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

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