Ljud#

Introduktion#

VEX AIR Drone Controller låter användare spela inbyggda ljud, anpassade ljudfiler och musiknoter. Den innehåller också kontroller för att stoppa ljud och upptäcka om ljud spelas upp.

Nedan följer en lista över alla tillgängliga metoder:

Åtgärder - Spela upp och stoppa ljud

  • play — Spelar upp ett inbyggt ljud från en fördefinierad lista.

  • play_file — Spelar upp ett användaruppladdat ljud.

  • play_note — Spelar en musiknot med en specificerad tonhöjd, oktav och längd.

  • stop — Stoppar alla ljud som spelas upp.

Getters - Hämta status för ljud

  • is_active — Kontrollerar om ett ljud spelas upp för närvarande.

Åtgärder#

play#

play spelar ett av kontrollenhetens inbyggda ljud med en specificerad volymprocent. Eftersom detta är en metod utan väntetid spelar kontrollenheten upp det inbyggda ljudet och går vidare till nästa kommando utan att vänta på att det ska slutföras.

Användande:

controller.sound.play(sound, volume)

Parameter

Beskrivning

sound

Ett av de inbyggda ljudalternativen som listas nedan.

volume

Valfritt. Volymen för ljudet, som ett heltal från 0 % till 100 %. Standardvärdet är 50 %.

Inbyggda ljud

Spela upp ljud

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 spelar upp ett anpassat ljud som laddats av användaren med en specificerad volymprocent. Eftersom detta är en metod utan väntetid spelar drönaren upp det anpassade ljudet och går vidare till nästa kommando utan att vänta på att det ska slutföras.

Användande:

controller.sound.play_file(file, volume)

Parameter

Beskrivning

file

En av de anpassade ljudfiler som laddats upp av användaren, från SOUND1 till SOUND10Ljudnumret överensstämmer med numret som visas i AIR-kontrollpanelen.

volume

Valfritt. Volymen för ljudet, som ett heltal från 0 % till 100 %. Standardvärdet är 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 spelar en specifik ton under en specifik tid. Eftersom detta är en metod utan väntetid spelar drönaren den specifika tonen och går vidare till nästa kommando utan att vänta på att det ska slutföras.

Användande:

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

Parameter

Beskrivning

note

Den musikaliska tonhöjden som ska spelas, skriven som en sträng (t.ex. C5, A#6). Giltiga toner är A till G (med valfritt # för kors) över oktaver 5 till 8.

duration

Notens längd, angiven som ett heltal i millisekunder.

volume

Valfritt. Notens volym, som ett heltal från 0 % till 100 %. Standardvärdet är 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 stoppar ett ljud som spelas upp.

Användande:

controller.sound.stop()

Parametrar

Beskrivning

Den här metoden har inga parametrar.

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

Getters#

is_active#

is_active returnerar ett booleskt värde som anger om drönaren för närvarande spelar upp ett ljud.

  • True — Ett ljud spelas upp just nu

  • False — Inget ljud spelas upp

Usage:
controller.sound.is_active()

Parametrar

Beskrivning

Den här metoden har inga parametrar.

 
# 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