winsound मॉड्यूल विंडोज ऑपरेटिंग सिस्टम पर पायथन इंस्टॉलेशन के लिए विशिष्ट है। मॉड्यूल निम्नलिखित फ़ंक्शन को परिभाषित करता है:
Beep()
जब इस फ़ंक्शन को कॉल किया जाता है तो पीसी के स्पीकर से एक बीप सुनाई देती है। फ़ंक्शन को दो पैरामीटर की आवश्यकता होती है। फ़्रीक्वेंसी पैरामीटर ध्वनि की फ़्रीक्वेंसी निर्दिष्ट करता है, और यह 37 से 32,767 हर्ट्ज की सीमा में होना चाहिए। ड्यूरेशन पैरामीटर ध्वनि की अवधि को मिलीसेकंड में निर्दिष्ट करता है।
>>> import winsound >>> winsound.Beep(1000, 500)
MessageBeep()
यह फ़ंक्शन रजिस्ट्री में निर्दिष्ट अनुसार ध्वनि बजाता है। टाइप तर्क निर्दिष्ट करता है कि कौन सी ध्वनि बजानी है। संभावित मान हैं:
-1, MB_ICONASTERISK, MB_ICONEXCLAMATION, MB_ICONHAND, MB_ICONQUESTION, और MB_OK (डिफ़ॉल्ट)।
मान -1 एक "साधारण बीप" उत्पन्न करता है।
>>> winsound.MessageBeep()
PlaySound()
यह फ़ंक्शन प्लेटफ़ॉर्म API से अंतर्निहित PlaySound() फ़ंक्शन को कॉल करता है। फ़ंक्शन को दो पैरामीटर की आवश्यकता होती है। साउंड पैरामीटर एक फ़ाइलनाम, एक सिस्टम साउंड उपनाम, या बाइट्स-जैसे ऑब्जेक्ट के रूप में ऑडियो डेटा हो सकता है। इसकी व्याख्या फ़्लैग्स के मान पर निर्भर करती है। फ़्लैग्स नीचे परिभाषित हैं:
| SND_FILENAME | साउंड पैरामीटर एक WAV फ़ाइल का नाम है। |
| SND_LOOP | ध्वनि को बार-बार बजाएं |
| SND_MEMORY | PlaySound() का साउंड पैरामीटर बाइट्स-जैसे ऑब्जेक्ट के रूप में WAV फ़ाइल की मेमोरी छवि है। |
| SND_ASYNC | तुरंत वापस लौटें, जिससे ध्वनि को अतुल्यकालिक रूप से बजाया जा सके। |
| SND_NODEFAULT | यदि निर्दिष्ट ध्वनि नहीं मिलती है, तो सिस्टम डिफ़ॉल्ट ध्वनि न बजाएं। |
| SND_NOSTOP | वर्तमान में बज रही ध्वनियों को बाधित न करें। |
निम्नलिखित कथन दी गई WAV फ़ाइल बजाता है।
>>> winsound.PlaySound('sample.wav', winsound.SND_FILENAME | winsound.SND_NOWAIT)
SND_ALIAS
विंडोज रजिस्ट्री कुंजियाँ ध्वनि नामों से जुड़ी होती हैं। यदि रजिस्ट्री में ऐसा कोई नाम नहीं है, तो SND_NODEFAULT के बिना सिस्टम डिफ़ॉल्ट ध्वनि बजाएं। सभी Win32 सिस्टम निम्नलिखित का समर्थन करते हैं:
| PlaySound() नाम | कंट्रोल पैनल ध्वनि नाम |
|---|---|
| 'SystemAsterisk' | Asterisk |
| 'SystemExclamation' | Exclamation |
| SystemExit' | Exit Windows |
| 'SystemHand' | Critical Stop |
| SystemQuestion' | Question |
उदाहरण के लिए निम्नलिखित कथन विंडोज एग्जिट ध्वनि बजाता है।
>>> winsound.PlaySound("SystemExit", winsound.SND_ALIAS)
winsound मॉड्यूल निम्नलिखित ध्वनियों को भी परिभाषित करता है:
| MB_ICONASTERISK | SystemDefault ध्वनि बजाएं। |
| MB_ICONEXCLAMATION | SystemExclamation ध्वनि बजाएं। |
| MB_ICONHAND | SystemHand ध्वनि बजाएं। |
| MB_ICONQUESTION | SystemQuestion ध्वनि बजाएं। |
| MB_OK | SystemDefault ध्वनि बजाएं |
