winsound — Διεπαφή αναπαραγωγής ήχου για Windows

The winsound module provides access to the basic sound-playing machinery provided by Windows platforms. It includes functions and several constants.

Διαθεσιμότητα: 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.