Skaņa#

Ievads#

VEX AIM kodēšanas robota skaņas ļauj lietotājiem atskaņot iebūvētās skaņas, pielāgotus audio failus un mūzikas notis. Tas ietver arī vadīklas skaņu apturēšanai un audio atskaņošanas noteikšanai.

Zemāk ir visu metožu saraksts:

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

  • play — Atskaņo iebūvēto skaņas efektu.

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

  • play_note — Atskaņo mūzikas noti noteiktu laiku.

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

Getter — pārbaudiet skaņas statusu.

  • is_active — Atgriež, vai pašlaik tiek atskaņota skaņa.

Darbības#

play#

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

Lietojums:

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

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 atskaņo lietotāja augšupielādētu pielāgotu skaņu. Tā kā šī ir metode bez gaidīšanas, robots atskaņo pielāgoto skaņu un pāriet uz nākamo komandu, negaidot tās pabeigšanu.

Lietojums:

robot.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 atbilst numuram, kas parādīts AIM 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%.

# 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 atskaņo noteiktu noti noteiktu laiku milisekundēs. Tā kā šī ir metode bez gaidīšanas, robots atskaņo konkrēto noti un pāriet uz nākamo komandu, negaidot tās beigas.

Lietojums:

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

length

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

volume

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

Lietojums:

robot.sound.stop()

Parametri

Apraksts

Šai metodei nav parametru.

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

Getteri#

is_active#

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

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

  • False — Nav atskaņota skaņa

Lietojums:

robot.sound.is_active()

Parametri

Apraksts

Šai metodei nav parametru.

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