winsound
— Διεπαφή αναπαραγωγής ήχου για Windows¶
Το module winsound
παρέχει πρόσβαση στην βασική μηχανή αναπαραγωγής ήχου που παρέχεται από τις πλατφόρμες Windows. Περιλαμβάνει συναρτήσεις και αρκετές σταθερές.
- winsound.Beep(frequency, duration)¶
Εκπέμπει ηχητικό σήμα από το ηχείο του υπολογιστή. Η παράμετρος frequency καθορίζει τη συχνότητα, σε hertz, του ήχου και πρέπει να είναι στο εύρος 37 έως 32.767. Η παράμετρος duration καθορίζει τον αριθμό των χιλιοστών του δευτερολέπτου που θα διαρκέσει ο ήχος. Εάν το σύστημα δεν μπορεί να κάνει ηχητικό σήμα στο ηχείο, γίνεται raise μια
RuntimeError
.
- winsound.PlaySound(sound, flags)¶
Καλεί την υποκείμενη συνάρτηση
PlaySound()
από το API της πλατφόρμας. Η παράμετρος sound μπορεί να είναι ένα όνομα αρχείου, ένα ψευδώνυμο συστήματος ήχου, δεδομένα ήχου ως bytes-like object, ήNone
. Η ερμηνεία της εξαρτάται από την τιμή των flags, τα οποία μπορούν να είναι ένας bitwise ORed συνδυασμός των σταθερών που περιγράφονται παρακάτω. Εάν η παράμετρος sound είναιNone
, οποιοσδήποτε ήχος κύματος που παίζει αυτή τη στιγμή σταματά. Εάν το σύστημα υποδεικνύει σφάλμα, κάνει raise μια εξαίρεσηRuntimeError
.
- winsound.MessageBeep(type=MB_OK)¶
Καλεί την υποκείμενη συνάρτηση
MessageBeep()
από το API της πλατφόρμας. Αυτό αναπαράγει έναν ήχο όπως καθορίζεται στο μητρώο. Το όρισμα type καθορίζει ποιος ήχος θα αναπαραχθεί. Οι δυνατές τιμές είναι-1
,MB_ICONASTERISK
,MB_ICONEXCLAMATION
,MB_ICONHAND
,MB_ICONQUESTION
καιMB_OK
, όλες περιγράφονται παρακάτω. Η τιμή-1
παράγει ένα «απλό ηχητικό σήμα». Αυτό είναι το τελικό εφεδρικό αν δεν μπορεί να αναπαραχθεί άλλος ήχος. Εάν το σύστημα υποδεικνύει σφάλμα, γίνεται raise μιαRuntimeError
.
- winsound.SND_FILENAME¶
The sound παράμετρος είναι το όνομα ενός αρχείου WAV. Μην το χρησιμοποιείτε με
SND_ALIAS
.
- winsound.SND_ALIAS¶
Η παράμετρος sound είναι ένα όνομα συσχέτισης ήχου από το μητρώο. Εάν το μητρώο δεν περιέχει τέτοιο όνομα, αναπαράγει τον προεπιλεγμένο ήχο του συστήματος, εκτός εάν έχει καθοριστεί επίσης
SND_NODEFAULT
. Εάν δεν είναι εγγεγραμμένος κανένας προεπιλεγμένος ήχος, γίνεται raise μιαRuntimeError
. Μην το χρησιμοποιείτε μεSND_FILENAME
.Όλα τα συστήματα Win32 υποστηρίζουν τουλάχιστον τα παρακάτω. Τα περισσότερα συστήματα υποστηρίζουν πολύ περισσότερα:
PlaySound()
nameΑντίστοιχο όνομα ήχου στον Πίνακα Ελέγχου
'SystemAsterisk'
Αστερίσκος
'SystemExclamation'
Αναφώνηση
'SystemExit'
Έξοδος από τα Windows
'SystemHand'
Κρίσιμη Διακοπή
'SystemQuestion'
Ερώτηση
Για παράδειγμα:
import winsound # Play Windows exit sound. winsound.PlaySound("SystemExit", winsound.SND_ALIAS) # Probably play Windows default sound, if any is registered (because # "*" probably isn't the registered name of any sound). winsound.PlaySound("*", winsound.SND_ALIAS)
- winsound.SND_LOOP¶
Αναπαράγει τον ήχο επανειλημμένα. Η σημαία
SND_ASYNC
πρέπει επίσης να χρησιμοποιηθεί για να αποφευχθεί το μπλοκάρισμα. Δεν μπορεί να χρησιμοποιηθεί μεSND_MEMORY
.
- winsound.SND_MEMORY¶
The sound παράμετρος της
PlaySound()
είναι μια εικόνα μνήμης ενός αρχείου WAV, ως bytes-like object.Σημείωση
Αυτό το module δεν υποστηρίζει την αναπαραγωγή από μια εικόνα μνήμης ασύγχρονα, οπότε ένας συνδυασμός αυτής της σημαίας και της
SND_ASYNC
θα εγείρειRuntimeError
.
- winsound.SND_PURGE¶
Σταματά την αναπαραγωγή όλων των περιπτώσεων του καθορισμένου ήχου.
Σημείωση
Αυτή η σημαία δεν υποστηρίζεται σε σύγχρονες πλατφόρμες Windows.
- winsound.SND_ASYNC¶
Επιστρέφει άμεσα, επιτρέποντας στους ήχους να αναπαράγονται ασύγχρονα.
- winsound.SND_NODEFAULT¶
Εάν ο καθορισμένος ήχος δεν μπορεί να βρεθεί, μην αναπαράγετε τον προεπιλεγμένο ήχο του συστήματος.
- winsound.SND_NOSTOP¶
Μην διακόπτετε τους ήχους που παίζουν αυτή τη στιγμή.
- winsound.SND_NOWAIT¶
Επιστρέφει άμεσα εάν ο οδηγός ήχου είναι απασχολημένος.
Σημείωση
Αυτή η σημαία δεν υποστηρίζεται σε σύγχρονες πλατφόρμες Windows.
- winsound.SND_APPLICATION¶
Η παράμετρος sound είναι ένα ψευδώνυμο συγκεκριμένης εφαρμογής στο μητρώο. Αυτή η σημαία μπορεί να συνδυαστεί με τη σημαία
SND_ALIAS
για να καθορίσει ένα ψευδώνυμο ήχου που ορίζεται από την εφαρμογή.
- winsound.SND_SENTRY¶
Πυροδοτεί ένα γεγονός SoundSentry όταν αναπαράγεται ο ήχος.
Added in version 3.14.
- winsound.SND_SYNC¶
Ο ήχος αναπαράγεται συγχρονισμένα. Αυτή είναι η προεπιλεγμένη συμπεριφορά.
Added in version 3.14.
- winsound.SND_SYSTEM¶
Αναθέτει τον ήχο στην συνεδρία ήχου για ήχους ειδοποίησης συστήματος.
Added in version 3.14.
- winsound.MB_ICONASTERISK¶
Αναπαράγει τον ήχο
SystemDefault
.
- winsound.MB_ICONEXCLAMATION¶
Αναπαράγει τον ήχο
SystemExclamation
.
- winsound.MB_ICONHAND¶
Αναπαράγει τον ήχο
SystemHand
.
- winsound.MB_ICONQUESTION¶
Αναπαράγει τον ήχο
SystemQuestion
.
- winsound.MB_OK¶
Αναπαράγει τον ήχο
SystemDefault
.
- winsound.MB_ICONERROR¶
Αναπαράγει τον ήχο
SystemHand
.Added in version 3.14.
- winsound.MB_ICONINFORMATION¶
Αναπαράγει τον ήχο
SystemDefault
.Added in version 3.14.
- winsound.MB_ICONSTOP¶
Αναπαράγει τον ήχο
SystemHand
.Added in version 3.14.
- winsound.MB_ICONWARNING¶
Αναπαράγει τον ήχο
SystemExclamation
.Added in version 3.14.