Garsas#

Įvadas#

„VEX AIR“ drono valdiklis leidžia vartotojams leisti integruotus garsus, pasirinktinius garso failus ir muzikines natas. Jame taip pat yra valdikliai garsams sustabdyti ir aptikti, ar garsas šiuo metu grojamas.

Žemiau pateikiamas visų galimų metodų sąrašas:

Veiksmai – leisti ir stabdyti garsus

  • play — Paleidžia integruotą garsą iš iš anksto nustatyto sąrašo.

  • play_file — Paleidžia vartotojo įkeltą garsą.

  • play_note — Groja muzikos natą su nurodytu aukščiu, oktava ir trukme.

  • stop — Sustabdo bet kokį šiuo metu grojamą garsą.

Getteriai – gaukite garsų būseną

  • is_active — Patikrina, ar šiuo metu grojamas garsas.

Veiksmai#

play#

play paleidžia vieną iš valdiklio integruotų garsų nurodytu garsumo procentais. Kadangi tai yra metodas be laukimo, valdiklis paleidžia integruotą garsą ir pereina prie kitos komandos nelaukdamas, kol ji bus baigta.

Naudojimas:

controller.sound.play(sound, volume)

Parametras

Aprašymas

sound

Vienas iš žemiau išvardytų integruotų garso parinkčių.

volume

Pasirinktinai. Garso stiprumas sveikuoju skaičiumi nuo 0 % iki 100 %. Numatytoji reikšmė yra 50 %.

Integruoti garsai

Leisti garsą

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 paleidžia vartotojo įkeltą pasirinktinį garsą nurodytu garsumo procentu. Kadangi tai yra metodas be laukimo, dronas paleidžia pasirinktinį garsą ir pereina prie kitos komandos nelaukdamas, kol ji bus baigta.

Naudojimas:

controller.sound.play_file(file, volume)

Parametras

Aprašymas

file

Vienas iš vartotojo įkeltų pasirinktinių garso failų nuo SOUND1 iki SOUND10Garso numeris sutampa su numeriu, rodomu AIR valdymo skydelyje.

volume

Pasirinktinai. Garso stiprumas sveikuoju skaičiumi nuo 0 % iki 100 %. Numatytoji reikšmė yra 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 groja konkrečią natą tam tikrą laiką. Kadangi tai yra metodas be laukimo, dronas groja konkrečią natą ir pereina prie kitos komandos nelaukdamas, kol ji bus baigta.

Naudojimas:

controller.sound.play_note(note, duration, volume)

Parametras

Aprašymas

note

Grojamas muzikinis aukštis, užrašytas kaip eilutė (pvz., C5, A#6). Galimos natos yra A iki G (su pasirinktinai # aštriems tonams) per 5–8 oktavas.

duration

Natos trukmė, nurodyta kaip sveikasis skaičius milisekundėmis.

volume

Pasirinktinai. Banknoto tūris sveikuoju skaičiumi nuo 0 % iki 100 %. Numatytoji reikšmė yra 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 sustabdo šiuo metu grojamą garsą.

Naudojimas:

controller.sound.stop()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

 
# 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()

Getteriai#

is_active#

is_active grąžina loginę reikšmę, nurodančią, ar dronas šiuo metu groja garsą.

  • True — Šiuo metu grojamas garsas

  • False — Garsas negirdimas

Usage:
controller.sound.is_active()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

 
# 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