Âm thanh#

Giới thiệu#

Robot lập trình VEX AIM cho phép người dùng phát các âm thanh tích hợp sẵn, các tệp âm thanh tùy chỉnh và các nốt nhạc. Nó cũng bao gồm các nút điều khiển để dừng âm thanh và phát hiện xem âm thanh có đang phát hay không.

Dưới đây là danh sách tất cả các phương pháp:

Thao tác — Phát hoặc dừng âm thanh.

  • play — Phát hiệu ứng âm thanh tích hợp.

  • play_file — Phát âm thanh tùy chỉnh do người dùng tải lên.

  • play_note — Phát một nốt nhạc trong một khoảng thời gian nhất định.

  • stop — Dừng bất kỳ âm thanh nào đang phát.

Getter — Kiểm tra trạng thái âm thanh.

  • is_active — Trả về liệu có âm thanh đang phát hay không.

Hành động#

play#

play phát một trong những âm thanh tích hợp sẵn của robot ở mức âm lượng được chỉ định. Vì đây là phương pháp không chờ đợi, robot sẽ phát âm thanh tích hợp sẵn và chuyển sang lệnh tiếp theo mà không cần đợi âm thanh đó kết thúc.

Cách sử dụng:

robot.sound.play(sound, volume)

Tham số

Sự miêu tả

sound

Một trong những tùy chọn âm thanh tích hợp được liệt kê bên dưới.

volume

Tùy chọn. Âm lượng, là số nguyên từ 0% đến 100%. Mặc định là 50%.

Âm thanh tích hợp

Phát âm thanh

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#

Lệnh play_file phát một âm thanh tùy chỉnh do người dùng tải lên. Vì đây là phương pháp không chờ đợi, robot sẽ phát âm thanh tùy chỉnh và chuyển sang lệnh tiếp theo mà không cần đợi lệnh đó hoàn thành.

Cách sử dụng:

robot.sound.play_file(file, volume)

Tham số

Sự miêu tả

file

Một trong những tệp âm thanh tùy chỉnh do người dùng tải lên, từ SOUND1 đến SOUND10Số âm thanh trùng khớp với số hiển thị trong bảng điều khiển AIM.

volume

Tùy chọn. Âm lượng, là số nguyên từ 0% đến 100%. Mặc định là 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#

Lệnh play_note phát một nốt nhạc cụ thể trong một khoảng thời gian cụ thể tính bằng mili giây. Vì đây là phương pháp không chờ đợi, robot sẽ phát nốt nhạc cụ thể đó và chuyển sang lệnh tiếp theo mà không cần đợi nó kết thúc.

Cách sử dụng:

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

Tham số

Sự miêu tả

note

Cao độ âm nhạc cần chơi, được viết dưới dạng chuỗi ký hiệu (ví dụ: C5, A#6). Các nốt hợp lệ là A đến G (với tùy chọn # cho các nốt thăng) trải dài từ quãng 5 đến 8.

length

Thời lượng của nốt nhạc, được biểu thị bằng số nguyên tính bằng mili giây.

volume

Tùy chọn. Âm lượng, là số nguyên từ 0% đến 100%. Mặc định là 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 dừng âm thanh đang phát.

Cách sử dụng:

robot.sound.stop()

Thông số

Sự miêu tả

Phương pháp này không có tham số.

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

Người nhận#

is_active#

is_active trả về giá trị Boolean cho biết liệu âm thanh có đang phát hay không.

  • True — Hiện đang có âm thanh đang phát

  • False — Không có âm thanh nào đang phát

Cách sử dụng:

robot.sound.is_active()

Thông số

Sự miêu tả

Phương pháp này không có tham số.

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