使用QMediaPlayer播放音频无声音问题（PyQt6钢琴应用开发）

核心问题1：音量参数设置错误 #

PyQt6中QAudioOutput.setVolume()的参数是0.0到1.0的浮点数，而非0-100的整数。你设置了audioOutput.setVolume(100)，这会导致音量被异常处理（实际相当于静音或超出有效范围），这是无声音的主要诱因。

核心问题2：QAudioOutput可能被垃圾回收 #

虽然你保存了QMediaPlayer实例，但QAudioOutput是局部变量，Python的垃圾回收机制可能会在后续回收它，导致音频输出失效。需要将QAudioOutput和播放器一起保存。

其他潜在问题：按键事件边界处理 #

当按下不在keyTextList中的按键时，会触发KeyError，需要增加判断逻辑避免程序崩溃。

修复后的完整代码 #

import sys, os

from PyQt6.QtWidgets import QMainWindow, QApplication
from PyQt6.QtCore import QUrl
from PyQt6.QtMultimedia import QMediaPlayer, QAudioOutput
from PyQt6.QtMultimediaWidgets import QVideoWidget


class MainWindow(QMainWindow):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.keyTextList = ['1', '2', '3', '4', '5', '6', '7', '8', 'q', 'w', 'e', 'r', 't', 'y', 'u', 'i', 'a', 's', 'd', 'f', 'g', 'h', 'j', 'k', 'z', 'x', 'c', 'v', 'b', 'n', 'm', ',']
        # 同时保存播放器和音频输出对象，避免被GC回收
        self.keyText2player = {}

        self.unfinishedDir = r'C:\Users\22815\Downloads\Real Guitar - Music Band Game_3.39.1_Apkpure\assets\sfx\distortion'
        self.toneFilePathList = ['1.ogg', '2.ogg', '3.ogg', '4.ogg', '5.ogg', '6.ogg', '7.ogg', '8.ogg', '9.ogg', '10.ogg', '11.ogg', '12.ogg', '13.ogg', '14.ogg', '15.ogg', '16.ogg', '17.ogg', '18.ogg', '19.ogg', '20.ogg', '21.ogg', '22.ogg', '23.ogg', '24.ogg', '25.ogg', '26.ogg', '27.ogg', '28.ogg', '29.ogg', '30.ogg', '31.ogg', '32.ogg', '33.ogg', '34.ogg', '35.ogg', '36.ogg', '37.ogg', '38.ogg', '39.ogg', '40.ogg', '41.ogg', '42.ogg', '43.ogg', '44.ogg']
        for index, keyText in enumerate(self.keyTextList):
            player, audio_output = self.createMediaPlayer(os.path.join(self.unfinishedDir, self.toneFilePathList[index]))
            self.keyText2player[keyText] = (player, audio_output)

    def keyPressEvent(self, event):
        key_text = event.text()
        # 先判断按键是否在映射表中，避免KeyError
        if key_text in self.keyText2player:
            player, _ = self.keyText2player[key_text]
            # 确保媒体加载完成后再播放
            if player.mediaStatus() == QMediaPlayer.MediaStatus.LoadedMedia:
                player.play()
            elif player.mediaStatus() == QMediaPlayer.MediaStatus.NoMedia:
                # 重新加载媒体（如果之前加载失败）
                player.setSource(player.source())
        return super().keyPressEvent(event)

    def onMediaStateChanged(self, status):
        print(status)

    def createMediaPlayer(self, filePath):
        print(filePath)
        player = QMediaPlayer()
        audio_output = QAudioOutput()
        player.setAudioOutput(audio_output)
        player.setSource(QUrl.fromLocalFile(filePath))
        # 设置正确的音量范围：0.0到1.0
        audio_output.setVolume(1.0)
        player.mediaStatusChanged.connect(self.onMediaStateChanged)
        return player, audio_output


def main():
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())


if __name__ == "__main__":
    main()

额外优化建议 #

• 可以添加错误捕获信号，排查文件加载或解码问题：

  player.errorOccurred.connect(lambda error, msg: print(f"播放错误: {error}, {msg}"))
  

• 若需要支持快速连续按键，可在播放前调用player.setPosition(0)重置播放位置，确保每次按键都能触发完整音频。

内容的提问来源于stack exchange，提问作者iMath