winsound --- Giao diện phát âm thanh cho Windows

---

Mô-đun winsound cung cấp quyền truy cập vào máy phát âm thanh cơ bản do nền tảng Windows cung cấp. Nó bao gồm các hàm và một số hằng số.

sẵn có: Windows.

winsound.Beep(frequency, duration)

Tiếng bíp của loa PC. Tham số frequency chỉ định tần số, tính bằng hertz, của âm thanh và phải nằm trong phạm vi từ 37 đến 32.767. Tham số duration chỉ định số mili giây mà âm thanh sẽ kéo dài. Nếu hệ thống không thể phát ra tiếng bíp, RuntimeError sẽ được nâng lên.

winsound.PlaySound(sound, flags)

Gọi hàm PlaySound() cơ bản từ Nền tảng API. Tham số sound có thể là tên tệp, bí danh âm thanh hệ thống, dữ liệu âm thanh dưới dạng bytes-like object hoặc None. Việc diễn giải nó phụ thuộc vào giá trị của flags, giá trị này có thể là sự kết hợp ORed theo bit của các hằng số được mô tả bên dưới. Nếu tham số sound là None, mọi âm thanh dạng sóng hiện đang phát sẽ bị dừng. Nếu hệ thống báo lỗi, RuntimeError sẽ được nâng lên.

winsound.MessageBeep(type=MB_OK)

Gọi hàm MessageBeep() cơ bản từ Nền tảng API. Điều này sẽ phát âm thanh như được chỉ định trong sổ đăng ký. Đối số type chỉ định âm thanh nào sẽ phát; các giá trị có thể là -1, MB_ICONASTERISK, MB_ICONEXCLAMATION, MB_ICONHAND, MB_ICONQUESTION và MB_OK, tất cả đều được mô tả bên dưới. Giá trị -1 tạo ra "tiếng bíp đơn giản"; đây là phương án dự phòng cuối cùng nếu không thể phát âm thanh khác. Nếu hệ thống báo lỗi, RuntimeError sẽ được nâng lên.

winsound.SND_FILENAME

Tham số sound là tên của tệp WAV. Không sử dụng với SND_ALIAS.

winsound.SND_ALIAS

Tham số sound là tên liên kết âm thanh từ sổ đăng ký. Nếu sổ đăng ký không chứa tên như vậy, hãy phát âm thanh mặc định của hệ thống trừ khi SND_NODEFAULT cũng được chỉ định. Nếu không có âm thanh mặc định nào được đăng ký, hãy tăng RuntimeError. Không sử dụng với SND_FILENAME.

Tất cả các hệ thống Win32 đều hỗ trợ ít nhất những điều sau; hầu hết các hệ thống đều hỗ trợ nhiều hơn nữa:

PlaySound() name	Tên âm thanh của bảng điều khiển tương ứng
'SystemAsterisk'	Dấu hoa thị
'SystemExclamation'	Dấu chấm than
'SystemExit'	Thoát Windows
'SystemHand'	Dừng quan trọng
'SystemQuestion'	Câu hỏi

Ví dụ:

nhập khẩu winound
# Play Âm thanh thoát Windows.
wonound.PlaySound("SystemExit", wonound.SND_ALIAS)

# Probably phát âm thanh mặc định của Windows, nếu có đã được đăng ký (vì
# "*" có lẽ không phải là tên đã đăng ký của bất kỳ âm thanh nào).
wonound.PlaySound("*", wonound.SND_ALIAS)

winsound.SND_LOOP

Phát âm thanh nhiều lần. Cờ SND_ASYNC cũng phải được sử dụng để tránh bị chặn. Không thể sử dụng với SND_MEMORY.

winsound.SND_MEMORY

Tham số sound cho PlaySound() là hình ảnh bộ nhớ của tệp WAV, dưới dạng bytes-like object.

Ghi chú

Mô-đun này không hỗ trợ phát không đồng bộ từ hình ảnh bộ nhớ, do đó, sự kết hợp giữa cờ này và SND_ASYNC sẽ tăng RuntimeError.

winsound.SND_PURGE

Dừng phát tất cả các trường hợp của âm thanh được chỉ định.

Ghi chú

Cờ này không được hỗ trợ trên nền tảng Windows hiện đại.

winsound.SND_ASYNC

Quay lại ngay lập tức, cho phép âm thanh phát không đồng bộ.

winsound.SND_NODEFAULT

Nếu không tìm thấy âm thanh được chỉ định, không phát âm thanh mặc định của hệ thống.

winsound.SND_NOSTOP

Không làm gián đoạn âm thanh đang phát.

winsound.SND_NOWAIT

Quay lại ngay nếu driver âm thanh đang bận.

Ghi chú

Cờ này không được hỗ trợ trên nền tảng Windows hiện đại.

winsound.SND_APPLICATION

Tham số sound là bí danh dành riêng cho ứng dụng trong sổ đăng ký. Cờ này có thể được kết hợp với cờ SND_ALIAS để chỉ định bí danh âm thanh do ứng dụng xác định.

winsound.SND_SENTRY

Kích hoạt sự kiện SoundSentry khi âm thanh được phát.

Added in version 3.14.

winsound.SND_SYNC

Âm thanh được phát đồng bộ. Đây là hành vi mặc định.

Added in version 3.14.

winsound.SND_SYSTEM

Gán âm thanh cho phiên âm thanh cho âm thanh thông báo hệ thống.

Added in version 3.14.

winsound.MB_ICONASTERISK

Phát âm thanh SystemDefault.

winsound.MB_ICONEXCLAMATION

Phát âm thanh SystemExclamation.

winsound.MB_ICONHAND

Phát âm thanh SystemHand.

winsound.MB_ICONQUESTION

Phát âm thanh SystemQuestion.

winsound.MB_OK

Phát âm thanh SystemDefault.

winsound.MB_ICONERROR

Phát âm thanh SystemHand.

Added in version 3.14.

winsound.MB_ICONINFORMATION

Phát âm thanh SystemDefault.

Added in version 3.14.

winsound.MB_ICONSTOP

Phát âm thanh SystemHand.

Added in version 3.14.

winsound.MB_ICONWARNING

Phát âm thanh SystemExclamation.

Added in version 3.14.