Garsas#

Įvadas#

„VEX AIM“ kodavimo roboto garsai leidžia vartotojams leisti integruotus garsus, pasirinktinius garso failus ir muzikines natas. Robotas taip pat apima valdiklius garsams sustabdyti ir aptikti, ar garsas šiuo metu grojamas.

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

Veiksmai – leisti arba sustabdyti garsus.

  • play — Paleidžia integruotą garso efektą.

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

  • play_note — Groja muzikos natą nustatytą laiką.

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

Getter – patikrinkite garso būseną.

  • is_active — Grąžina, ar šiuo metu grojamas garsas.

Veiksmai#

play#

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

Naudojimas:

robot.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ą

ACT_ANGRY

ACT_EXCITED

ACT_HAPPY

ACT_SAD

ACT_SILLY

BLINKER

BRAKES

CHEER

CHIRP

COMPLETE

CRASH

DETECTED

DOORBELL

FAIL

FLOURISH

HUAH

LOOPING

MOVE_FORWARD

MOVE_REVERSE

OBSTACLE

PAUSE

PICKUP

RECEIVE

RESUME

SENSING

SEND

SPARKLE

TADA

TURN_LEFT

TURN_RIGHT

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

Naudojimas:

robot.sound.play_file(file, volume)

Parametras

Aprašymas

file

Vienas iš vartotojo įkeltų pasirinktinių garso failų nuo SOUND1 iki SOUND10Garso numeris atitinka numerį, rodomą AIM valdymo skydelyje.

volume

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

Naudojimas:

robot.sound.play_note(note, length, 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.

length

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

volume

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

Naudojimas:

robot.sound.stop()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

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

Getteriai#

is_active#

is_active grąžina loginę reikšmę, nurodančią, ar šiuo metu grojamas garsas.

  • True — Šiuo metu grojamas garsas

  • False — Garsas negirdimas

Naudojimas:

robot.sound.is_active()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

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