Skaņa#

Ievads#

VEX AIR drona kontrolieris ļauj lietotājiem atskaņot iebūvētās skaņas, pielāgotus audio failus un mūzikas notis. Tas ietver arī vadības ierīces skaņu apturēšanai un audio atskaņošanas noteikšanai.

Zemāk ir visu pieejamo metožu saraksts:

Darbības — atskaņot un apturēt skaņas

  • play — Atskaņo iebūvēto skaņu no iepriekš definēta saraksta.

  • play_file — Atskaņo lietotāja augšupielādētu skaņu.

  • play_note — Atskaņo mūzikas noti ar noteiktu augstumu, oktāvu un ilgumu.

  • stop — Aptur jebkuru pašlaik atskaņoto skaņu.

Iegūtāji — skaņu statusa iegūšana

  • is_active — Pārbauda, ​​vai pašlaik tiek atskaņota skaņa.

Darbības#

play#

play atskaņo vienu no kontroliera iebūvētajām skaņām ar noteiktu skaļuma procentuālo daļu. Tā kā šī ir metode bez gaidīšanas, kontrolieris atskaņo iebūvēto skaņu un pāriet uz nākamo komandu, negaidot tās pabeigšanu.

Lietojums:

controller.sound.play(sound, volume)

Parametrs

Apraksts

sound

Viena no tālāk norādītajām iebūvētajām skaņas opcijām.

volume

Neobligāti. Skaņas skaļums kā vesels skaitlis no 0% līdz 100%. Noklusējuma vērtība ir 50%.

Iebūvētās skaņas

Atskaņot skaņu

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 atskaņo lietotāja ielādētu pielāgotu skaņu ar noteiktu skaļuma procentuālo daļu. Tā kā šī ir metode bez gaidīšanas, drons atskaņo pielāgoto skaņu un pāriet uz nākamo komandu, negaidot tās pabeigšanu.

Lietojums:

controller.sound.play_file(file, volume)

Parametrs

Apraksts

file

Viens no lietotāja augšupielādētajiem pielāgotajiem skaņas failiem no SOUND1 līdz SOUND10Skaņas numurs sakrīt ar numuru, kas parādīts AIR vadības panelī.

volume

Neobligāti. Skaņas skaļums kā vesels skaitlis no 0% līdz 100%. Noklusējuma vērtība ir 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 atskaņo noteiktu noti noteiktu laiku. Tā kā šī ir metode bez gaidīšanas, drons atskaņo konkrēto noti un pāriet uz nākamo komandu, negaidot tās beigas.

Lietojums:

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

Parametrs

Apraksts

note

Atskaņojamais muzikālais augstums, kas pierakstīts kā virkne (piemēram, C5, A#6). Derīgas notis ir A līdz G (ar papildu # asu notīm) 5. līdz 8. oktāvā.

duration

Nots ilgums, kas norādīts kā vesels skaitlis milisekundēs.

volume

Neobligāti. Banknotes apjoms kā vesels skaitlis no 0% līdz 100%. Noklusējuma vērtība ir 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 aptur skaņu, kas pašlaik tiek atskaņota.

Lietojums:

controller.sound.stop()

Parametri

Apraksts

Šai metodei nav parametru.

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

Getteri#

is_active#

is_active atgriež Būla vērtību, kas norāda, vai drons pašlaik atskaņo skaņu.

  • True — Pašlaik tiek atskaņota skaņa

  • False — Nav atskaņota skaņa

Usage:
controller.sound.is_active()

Parametri

Apraksts

Šai metodei nav parametru.

# 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!")