Ääni#

Johdanto#

VEX AIR -droonin ohjaimella 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 käytettävissä olevista menetelmistä:

Toiminnot - Äänien toisto ja pysäytys

  • play — Toistaa sisäänrakennetun äänen ennalta määritetystä luettelosta.

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

  • play_note — Soittaa nuotin tietyllä sävelkorkeudella, oktaavilla ja kestolla.

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

Getters - Äänien tilan hakeminen

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

Toiminnot#

play#

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

Käyttö:

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

SUCCESS

FAULT

SENSING

DETECTED

OBSTACLE

LOOPING

COMPLETE

PAUSE

RESUME

SEND

RECEIVE

 

# Play the looping sound.
controller.sound.play(LOOPING)


# Play the looping sound at full volume.
controller.sound.play(LOOPING, 100)


# Play the looping sound. 
# Wait until the sound is finished before taking off.
controller.sound.play(LOOPING)
while controller.sound.is_active():
    wait(50, MSEC)
drone.take_off(climb_to=500)
wait(1, SECONDS)
drone.land()

play_file#

play_file toistaa käyttäjän lataaman mukautetun äänen tietyllä äänenvoimakkuusprosentilla. Koska tämä on odotuskelvoton menetelmä, drone toistaa mukautetun äänen ja siirtyy seuraavaan komentoon odottamatta sen päättymistä.

Käyttö:

controller.sound.play_file(file, volume)

Parametri

Kuvaus

file

Yksi käyttäjän lataamista mukautetuista äänitiedostoista väliltä SOUND1 - SOUND10Äänen numero on linjassa AIR-ohjauspaneelissa näkyvän numeron kanssa.

volume

Valinnainen. Äänenvoimakkuus kokonaislukuna 0–100 %. Oletusarvo on 50 %.

 
# Upload a sound file in VEXcode.
# Play the custom sound.
controller.sound.play_file(SOUND1)


# Upload a sound file in VEXcode.
# Play the custom sound at full volume.
controller.sound.play_file(SOUND1, 100)


# Play the custom sound sound. 
# Wait until the sound is finished before taking off.
controller.sound.play_file(SOUND1)
while controller.sound.is_active():
    wait(50, MSEC)
drone.take_off(climb_to=500)
wait(1, SECONDS)
drone.land()

play_note#

play_note soittaa tietyn nuotin tietyn ajan. Koska tämä on odotuskelvoton menetelmä, drone soittaa tietyn nuotin ja siirtyy seuraavaan komentoon odottamatta sen päättymistä.

Käyttö:

controller.sound.play_note(note, duration, 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ä.

duration

Nuotin kesto millisekunteina kokonaislukuna.

volume

Valinnainen. Muistiinpanon äänenvoimakkuus kokonaislukuna väliltä 0–100 %. Oletusarvo on 50 %.

 
# Play C5 for 2 seconds
controller.sound.play_note("C5", 2000)


# Play C5 for 2 seconds at full volume
controller.sound.play_note("C5", 2000, 100)


# Play a short tune.
controller.sound.play_note("C5", 1000)
while controller.sound.is_active():
    wait(50, MSEC)
controller.sound.play_note("D5", 1000)
while controller.sound.is_active():
    wait(50, MSEC)
controller.sound.play_note("E5", 250)
while controller.sound.is_active():
    wait(50, MSEC)

stop#

stop pysäyttää parhaillaan toistettavan äänen.

Käyttö:

controller.sound.stop()

Parametrit

Kuvaus

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

 
# Upload a sound 10 seconds or greater in VEXcode.
# Stop the sound while it is playing.
controller.sound.play_file(SOUND1)
wait(6, SECONDS)
controller.sound.stop()

Getterit#

is_active#

is_active palauttaa totuusarvon, joka ilmaisee, toistaako drone parhaillaan ääntä.

  • True — Ääntä toistetaan parhaillaan

  • False — Ääntä ei toisteta

Usage:
controller.sound.is_active()

Parametrit

Kuvaus

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

 
# Display text once a sound starts playing
controller.sound.play(LOOPING)
while not controller.sound.is_active():
    wait(50, MSEC)
print("I hear the sound!")
On this page