jdZddlZddlZddlZddlmZmZ ddlZdZn#e $rdZdZYnwxYwGddZ e Z de d e d dfd Z d eee e fd dfd Zded dfdZddZddZdS)uThư viện phát tín hiệu âm thanh phản hồi (Audio Feedback) an toàn luồng cho AutoPOE2. Sử dụng hàng đợi bounded Queue kết hợp một luồng nền Daemon duy nhất để xử lý tất cả các yêu cầu phát tiếng Bíp. Triệt tiêu hoàn toàn tình trạng rò rỉ luồng vô thừa nhận (unmanaged thread leak) do việc liên tục gọi threading.Thread().start() gây ra. Tuân thủ nghiêm ngặt chuẩn tài liệu Google Docstrings theo Rule 16. N)ListTupleTFc\eZdZdZd defdZd dZdeeeefddfd Z d d Z dS) _AudioDispatcherudBộ điều phối âm thanh nền Singleton, thread-safe và không rò rỉ tài nguyên luồng.max_queue_sizectj||_tj|jdd|_d|_tj|_ dS)N)maxsizeTAutoPOE2_AudioFeedbackWorker)targetdaemonnameF) queueQueue_queue threadingThread _worker_loop_thread_startedLock_lock)selfrs 1C:\Projects\AutoPOE2\src\common\audio_feedback.py__init__z_AudioDispatcher.__init__sV:?+n:]:]:] )2)9$T8V* * *   ^%% returnNc|jsI|j5|js |jd|_ddddS#1swxYwYdSdS)NT)rrrstart)rs r_ensure_startedz _AudioDispatcher._ensure_started!s} ) ) )})L&&((($(DM ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) )s(AA AbeepsctrtjdkrdS| |j|dS#t j$rYdSwxYw)udĐưa danh sách nốt bíp [(tần số Hz, thời lượng ms)] vào hàng đợi phát âm thanh.ntN) _HAS_WINSOUNDosrr r put_nowaitrFull)rr!s r enqueue_beepsz_AudioDispatcher.enqueue_beeps(sp 4 F   K " "5 ) ) ) ) )z    DD sA AAc |j}|D]2\}} ttj||##t$rY/wxYw|jn#t$rYnwxYwz)N)rgetwinsoundBeep Exception task_done)rr!freqdurations rrz_AudioDispatcher._worker_loop3s   ))&+ND(#/$M$999$ %%''''     s4 A+AA+ A A+ AA++ A87A8)rrN) __name__ __module__ __qualname____doc__intrr rrr(rrrrrsnn&&s&&&&)))) 4c3h#8 T          rrr/r0rc@t||fgdS)uĐưa một nốt bíp đơn lẻ vào hàng đợi phát âm thanh nền (Non-blocking). Args: freq: Tần số âm thanh (Hz), ví dụ: 600, 1200, 1800. duration: Thời lượng phát âm thanh (ms), ví dụ: 100. N _dispatcherr()r/r0s r enqueue_beepr;Es&h/011111rr!c:t|dS)ujĐưa danh sách nốt bíp [(tần số Hz, thời lượng ms)] vào hàng đợi phát âm thanh nền.Nr9)r!s rr(r(Ose$$$$$renabledcz|rtdgdStdgdS)uPhát tín hiệu âm thanh thông báo trạng thái Bật/Tắt của Bot (Non-blocking). Phát âm thanh tần số cao báo hiệu kích hoạt và âm trầm báo hiệu vô hiệu hóa. Args: enabled: True nếu bot vừa được bật, False nếu vừa được tắt. Thread-safety: Thread-safe. Non-blocking, đẩy tác vụ vào hàng đợi nền. Example: >>> beep_bot_toggle(True) # Âm báo bật (1200Hz) >>> beep_bot_toggle(False) # Âm báo tắt (600Hz) )id)iXxNr9)r=s rbeep_bot_togglerAUsD0!!;-00000!!:,/////rc>tddgdS)uPhát chuỗi âm thanh báo động khẩn cấp khi gặp sự cố nghiêm trọng (Panic Alarm). Phát 2 nốt cao liên tiếp (1800Hz) để cảnh báo tức thì người dùng khi có sự cố như ngắt kết nối game đột ngột, vi phạm bất biến hoặc kích hoạt Emergency Logout. Thread-safety: Thread-safe. Non-blocking. Example: >>> beep_panic() )r@)rCNr9r7rr beep_panicrEjs#{K899999rc<tdgdS)u]Phát âm thanh thông báo nhẹ khi hoàn thành một tác vụ thông thường. Phù hợp cho các sự kiện như nhặt được đồ giá trị cao, hoàn thành map, hoặc hoàn tất chu trình định danh vật phẩm. Thread-safety: Thread-safe. Non-blocking. Example: >>> beep_notification() )iPNr9r7rrbeep_notificationrHys yk*****rr1)r5r%rrtypingrrr+r$ ImportErrorrr:r6r;r(boolrArErHr7rrrLsj OOOMMHMMM ))))))))X  2s2c2d2222%eCHo.%4%%%% 0T0d0000* : : : : + + + + + +s  ++