Misceláneo PyQt: teclado y sonidos
Detalles útiles de PyQt6: controlar tecla mantenida con isAutoRepeat, reproducir audio con QMediaPlayer y QSoundEffect, y por qué el código cambia entre versiones de PyQt.
terminal
isAutoRepeat en keyPressEvent
El método keyPressEvent detecta cuándo se presiona una tecla. Una situación interesante es mantener una tecla presionada mucho tiempo: por defecto, el método se llama múltiples veces mientras la tecla siga abajo.
A veces no queremos que el método se ejecute repetidamente por mantener la tecla. Para eso sirve isAutoRepeat(): retorna un booleano que indica si el evento fue la primera pulsación (False) o una repetición por mantener presionado (True).
python
class MiVentana(QWidget): def keyPressEvent(self, evento: QKeyEvent) -> None: # La W cuenta TODAS las veces (incluye repeticiones) if evento.key() == Qt.Key.Key_W: self.contador_w += 1 self.label_w_contador.setText(f'Presionada {self.contador_w} veces') # La A solo cuenta la PRIMERA pulsacion (ignora repeticiones) if evento.key() == Qt.Key.Key_A and not evento.isAutoRepeat(): self.contador_a += 1 self.label_a_contador.setText(f'Presionada {self.contador_a} veces')En el ejemplo, al mantener presionada la W el contador sube sin parar, porque cuenta cada repetición. En cambio, la A incluye and not evento.isAutoRepeat(), así que solo suma una vez por cada pulsación real, sin importar cuánto la mantengas.
Cargando Quiz...
science
Sonidos: QMediaPlayer (.mp3)
Una interfaz suele necesitar música o efectos de sonido. PyQt6 ofrece dos objetos para reproducir audio; el primero es QMediaPlayer, que reproduce archivos .mp3.
Para configurarlo correctamente:
- Instanciar
QMediaPlayer(self). - Instanciar
QAudioOutput(self). - Conectarlos:
player.setAudioOutput(audio_output). - Obtener el _path_ absoluto del sonido a partir del relativo con
os.path.abspath(...). - Crear un
QUrlconQUrl.fromLocalFile(path). - Entregárselo al player con
setSource(...). - Reproducir con
play().
python
import osfrom os.path import joinfrom PyQt6.QtCore import QUrlfrom PyQt6.QtMultimedia import QMediaPlayer, QAudioOutput self.player = QMediaPlayer(self)self.audio_output = QAudioOutput(self)self.player.setAudioOutput(self.audio_output) # Path absoluto a partir del relativo (necesario para que PyQt lo reproduzca)science
Sonidos: QSoundEffect (.wav)
El segundo objeto es QSoundEffect, que reproduce archivos .wav. Su configuración es más directa que la de QMediaPlayer.
Pasos:
- Instanciar
QSoundEffect(self). - Crear el
QUrlconQUrl.fromLocalFile(...). - Entregárselo con
setSource(url). - Reproducir con
play()(ystop()para detenerlo).
python
from PyQt6.QtMultimedia import QSoundEffect self.media_player_wav = QSoundEffect(self)self.media_player_wav.setVolume(0.1) # opcionalfile_url = QUrl.fromLocalFile(join('sounds', 'see-you-again.wav'))self.media_player_wav.setSource(file_url) # Reproducir / detenerself.media_player_wav.play()# self.media_player_wav.stop()info
Versiones de PyQt
Todo lo visto está pensado para PyQt6. Si por alguna razón usas otra versión (por ejemplo PyQt5), puede que necesites ajustar el código: no siempre lo que funciona en una versión funciona igual en otra.
Un ejemplo concreto es reproducir un MP3. En PyQt5 se usaba QMediaContent con setMedia; en PyQt6 se usa QAudioOutput con setSource:
python
# PyQt5self.player = QMediaPlayer(self)path = os.path.abspath(join('sounds', 'waku-waku.mp3'))content = QMediaContent(QUrl.fromLocalFile(path))self.player.setMedia(content) # PyQt6self.media_player_mp3 = QMediaPlayer(self)self.media_player_mp3.setAudioOutput(QAudioOutput(self))file_url = QUrl.fromLocalFile(join('sounds', 'waku-waku.mp3'))