Suara

Perkenalan

Robot Coding VEX AIM memiliki fitur suara yang memungkinkan pengguna untuk memutar suara bawaan, file audio kustom, dan not musik. Robot ini juga menyertakan kontrol untuk menghentikan suara dan mendeteksi apakah audio sedang diputar.

Berikut adalah daftar semua metode:

Aksi — Putar atau hentikan suara.

• play — Memainkan efek suara bawaan.

• play_file — Memutar suara kustom yang diunggah pengguna.

• play_note — Memainkan nada musik selama durasi tertentu.

• stop — Menghentikan suara yang sedang diputar.

Getter — Periksa status suara.

• is_active — Mengembalikan apakah suara sedang diputar.

Tindakan

play

Perintah play akan memutar salah satu suara bawaan robot pada persentase volume tertentu. Karena ini adalah metode tanpa menunggu, robot akan memutar suara bawaan dan beralih ke perintah berikutnya tanpa menunggu suara tersebut selesai.

Penggunaan:

robot.sound.play(sound, volume)

Parameter	Keterangan
sound	Salah satu opsi suara bawaan yang tercantum di bawah ini.
volume	Opsional. Volume suara, sebagai bilangan bulat dari 0% hingga 100%. Nilai default adalah 50%.

Suara Bawaan	Putar Suara
ACT_ANGRY	Mainkan
ACT_EXCITED	Mainkan
ACT_HAPPY	Mainkan
ACT_SAD	Mainkan
ACT_SILLY	Mainkan
BLINKER	Mainkan
BRAKES	Mainkan
CHEER	Mainkan
CHIRP	Mainkan
COMPLETE	Mainkan
CRASH	Mainkan
DETECTED	Mainkan
DOORBELL	Mainkan
FAIL	Mainkan
FLOURISH	Mainkan
HUAH	Mainkan
LOOPING	Mainkan
MOVE_FORWARD	Mainkan
MOVE_REVERSE	Mainkan
OBSTACLE	Mainkan
PAUSE	Mainkan
PICKUP	Mainkan
RECEIVE	Mainkan
RESUME	Mainkan
SENSING	Mainkan
SEND	Mainkan
SPARKLE	Mainkan
TADA	Mainkan
TURN_LEFT	Mainkan
TURN_RIGHT	Mainkan

# 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

Perintah play_file memutar suara kustom yang diunggah oleh pengguna. Karena ini adalah metode tanpa menunggu, robot memutar suara kustom dan beralih ke perintah berikutnya tanpa menunggu hingga selesai.

Penggunaan:

robot.sound.play_file(file, volume)

Parameter	Keterangan
file	Salah satu file suara kustom yang diunggah oleh pengguna, dari SOUND1 hingga SOUND10Nomor suara tersebut sesuai dengan nomor yang ditampilkan di panel kontrol AIM.
volume	Opsional. Volume suara, sebagai bilangan bulat dari 0% hingga 100%. Nilai default adalah 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

Perintah play_note memainkan nada tertentu untuk durasi tertentu dalam milidetik. Karena ini adalah metode tanpa menunggu, robot memainkan nada tertentu dan beralih ke perintah berikutnya tanpa menunggu hingga selesai.

Penggunaan:

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

Parameter	Keterangan
note	Nada musik yang akan dimainkan, ditulis sebagai string (misalnya, C5, A#6). Nada yang valid adalah A hingga G (dengan opsional # untuk nada kres) di seluruh oktaf 5 hingga 8.
length	Durasi nada, diberikan sebagai bilangan bulat dalam milidetik.
volume	Opsional. Volume suara, sebagai bilangan bulat dari 0% hingga 100%. Nilai default adalah 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 menghentikan suara yang sedang diputar.

Penggunaan:

robot.sound.stop()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

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

Pencari

is_active

is_active mengembalikan nilai Boolean yang menunjukkan apakah suara sedang diputar saat ini.

• True — Suara sedang diputar

• False — Tidak ada suara yang diputar

Penggunaan:

robot.sound.is_active()

Parameter	Keterangan
	Metode ini tidak memiliki parameter.

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