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.