Dźwięk

Wstęp

Dźwięki robota VEX AIM Coding Robot pozwalają użytkownikom odtwarzać wbudowane dźwięki, niestandardowe pliki audio i nuty. Robot posiada również elementy sterujące do zatrzymywania dźwięków i wykrywania, czy dźwięk jest aktualnie odtwarzany.

Poniżej znajduje się lista wszystkich metod:

Akcje — odtwarzanie lub zatrzymywanie dźwięków.

• play — Odtwarza wbudowany efekt dźwiękowy.

• play_file — Odtwarza niestandardowy dźwięk przesłany przez użytkownika.

• play_note — Odtwarza nutę muzyczną przez ustalony czas trwania.

• stop — Zatrzymuje aktualnie odtwarzany dźwięk.

Getter — Sprawdź stan dźwięku.

• is_active — Zwraca informację, czy dźwięk jest obecnie odtwarzany.

Akcje

play

play odtwarza jeden z wbudowanych dźwięków robota z określoną głośnością. Ponieważ jest to metoda bez czekania, robot odtwarza wbudowany dźwięk i przechodzi do następnego polecenia bez czekania na jego zakończenie.

Stosowanie:

robot.sound.play(sound, volume)

Parametr	Opis
sound	Jedna z wbudowanych opcji dźwiękowych wymienionych poniżej.
volume	Opcjonalnie. Głośność dźwięku wyrażona jako liczba całkowita od 0% do 100%. Wartość domyślna to 50%.

Wbudowane dźwięki	Odtwórz dźwięk
ACT_ANGRY	Odtwórz
ACT_EXCITED	Odtwórz
ACT_HAPPY	Odtwórz
ACT_SAD	Odtwórz
ACT_SILLY	Odtwórz
BLINKER	Odtwórz
BRAKES	Odtwórz
CHEER	Odtwórz
CHIRP	Odtwórz
COMPLETE	Odtwórz
CRASH	Odtwórz
DETECTED	Odtwórz
DOORBELL	Odtwórz
FAIL	Odtwórz
FLOURISH	Odtwórz
HUAH	Odtwórz
LOOPING	Odtwórz
MOVE_FORWARD	Odtwórz
MOVE_REVERSE	Odtwórz
OBSTACLE	Odtwórz
PAUSE	Odtwórz
PICKUP	Odtwórz
RECEIVE	Odtwórz
RESUME	Odtwórz
SENSING	Odtwórz
SEND	Odtwórz
SPARKLE	Odtwórz
TADA	Odtwórz
TURN_LEFT	Odtwórz
TURN_RIGHT	Odtwórz

# 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 odtwarza niestandardowy dźwięk przesłany przez użytkownika. Ponieważ jest to metoda bez oczekiwania, robot odtwarza niestandardowy dźwięk i przechodzi do następnego polecenia bez czekania na jego zakończenie.

Stosowanie:

robot.sound.play_file(file, volume)

Parametr	Opis
file	Jeden z niestandardowych plików dźwiękowych przesłanych przez użytkownika, od SOUND1 do SOUND10Numer dźwięku odpowiada numerowi wyświetlanemu w panelu sterowania AIM.
volume	Opcjonalnie. Głośność dźwięku wyrażona jako liczba całkowita od 0% do 100%. Wartość domyślna to 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 odtwarza określoną nutę przez określony czas w milisekundach. Ponieważ jest to metoda bez oczekiwania, robot odtwarza określoną nutę i przechodzi do następnego polecenia bez czekania na jego zakończenie.

Stosowanie:

robot.sound.play_note(note, length, volume)

Parametr	Opis
note	Wysokość dźwięku do zagrania, zapisana jako ciąg (np. C5, A#6). Prawidłowe nuty to A do G (z opcjonalnym # dla krzyżyków) w oktawach od 5 do 8.
length	Czas trwania nuty wyrażony jako liczba całkowita w milisekundach.
volume	Opcjonalnie. Głośność dźwięku wyrażona jako liczba całkowita od 0% do 100%. Wartość domyślna to 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 zatrzymuje aktualnie odtwarzany dźwięk.

Stosowanie:

robot.sound.stop()

Parametry	Opis
	Ta metoda nie ma żadnych parametrów.

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

Getters

is_active

is_active zwraca wartość logiczną wskazującą, czy dźwięk jest obecnie odtwarzany.

• True — aktualnie odtwarzany jest dźwięk

• False — Nie odtwarza się żaden dźwięk

Stosowanie:

robot.sound.is_active()

Parametry	Opis
	Ta metoda nie ma żadnych parametrów.

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