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

Source code: PC/winsound.c

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

Διαθεσιμότητα: Windows.

## Functions

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`.

## Constants

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.