Suara#

Perkenalan#

Pengontrol Drone VEX AIR memungkinkan pengguna untuk memutar suara bawaan, file audio kustom, dan not musik. Pengontrol ini juga menyertakan kontrol untuk menghentikan suara dan mendeteksi apakah audio sedang diputar.

Berikut adalah daftar semua metode yang tersedia:

Aksi - Memutar dan Menghentikan Suara

  • play — Memainkan suara bawaan dari daftar yang telah ditentukan.

  • play_file — Memutar suara yang diunggah pengguna.

  • play_note — Memainkan nada musik dengan pitch, oktaf, dan durasi yang ditentukan.

  • stop — Menghentikan suara yang sedang diputar.

Getter - Mendapatkan Status Suara

  • is_active — Memeriksa apakah suara sedang diputar.

Tindakan#

play#

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

Penggunaan:

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

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#

Perintah play_file memutar suara kustom yang dimuat oleh pengguna pada persentase volume tertentu. Karena ini adalah metode tanpa menunggu, drone akan memutar suara kustom dan beralih ke perintah berikutnya tanpa menunggu hingga selesai.

Penggunaan:

controller.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 AIR.

volume

Opsional. Volume suara, sebagai bilangan bulat dari 0% hingga 100%. Nilai default adalah 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 memainkan nada tertentu untuk durasi tertentu. Karena ini adalah metode tanpa menunggu, drone memainkan nada tertentu dan beralih ke perintah berikutnya tanpa menunggu hingga selesai.

Penggunaan:

controller.sound.play_note(note, duration, 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.

duration

Durasi nada, diberikan sebagai bilangan bulat dalam milidetik.

volume

Opsional. Volume not, sebagai bilangan bulat dari 0% hingga 100%. Nilai default adalah 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 menghentikan suara yang sedang diputar.

Penggunaan:

controller.sound.stop()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

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

Pencari#

is_active#

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

  • True — Suara sedang diputar

  • False — Tidak ada suara yang diputar

Usage:
controller.sound.is_active()

Parameter

Keterangan

Metode ini tidak memiliki parameter.

 
# 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