PyQt6按钮点击播放音频问题：无法触发单次/循环播放

你的代码无法播放音频，通常是由以下几个问题导致的，对应修复方法如下：

1. 媒体文件路径错误 #

如果sound.mp3不在程序运行的当前工作目录，QMediaPlayer会找不到文件。解决办法是使用绝对路径定位文件：

import os
# 获取当前脚本所在目录
script_dir = os.path.dirname(os.path.abspath(__file__))
filename = os.path.join(script_dir, "sound.mp3")

2. 未等待媒体加载完成就调用播放 #

QMediaPlayer需要先完成媒体资源加载，直接调用play()会因为资源未就绪而失败。可以在播放前检查媒体状态，确保处于LoadedMedia状态：

def play_once(self):
    if self.player.mediaStatus() == QMediaPlayer.MediaStatus.LoadedMedia:
        self.player.play()
    else:
        print("媒体未加载或文件不存在")

3. 循环播放状态未重置 #

点击循环播放按钮后，播放器会保持无限循环状态，此时再点击单次播放按钮，音频依然会循环。需要在单次播放方法中重置循环次数为Once：

def play_once(self):
    self.player.setLoops(QMediaPlayer.Loops.Once)
    if self.player.mediaStatus() == QMediaPlayer.MediaStatus.LoadedMedia:
        self.player.play()

def play_endlessly(self):
    self.player.setLoops(QMediaPlayer.Loops.Infinite)
    if self.player.mediaStatus() == QMediaPlayer.MediaStatus.LoadedMedia:
        self.player.play()

4. 可选：检查多媒体插件支持 #

如果以上修复后仍无法播放，可能是缺少PyQt6多媒体插件或系统不支持MP3解码：

• Windows：确保安装了支持MP3的组件（如Windows Media Player相关组件）
• Linux：安装gstreamer相关插件（如gstreamer1.0-plugins-good、gstreamer1.0-plugins-ugly）
• macOS：通常系统自带MP3支持，若有问题可检查PyQt6安装完整性

完整修复代码 #

import sys
import os
from PyQt6.QtCore import QUrl
from PyQt6.QtMultimedia import QMediaPlayer, QAudioOutput
from PyQt6.QtWidgets import QWidget, QPushButton, QVBoxLayout, QApplication


class SoundPlayer(QWidget):
    def __init__(self):
        super().__init__()

        # 用绝对路径定位音频文件
        script_dir = os.path.dirname(os.path.abspath(__file__))
        filename = os.path.join(script_dir, "sound.mp3")
        
        self.player = QMediaPlayer()
        self.audio_output = QAudioOutput()
        self.player.setAudioOutput(self.audio_output)
        self.player.setSource(QUrl.fromLocalFile(filename))
        self.audio_output.setVolume(50)

        # 绑定错误信号，便于调试
        self.player.errorOccurred.connect(self._handle_media_error)

        self.play_button = QPushButton('Play')
        self.play_endlessly_button = QPushButton('Play Endlessly')

        layout = QVBoxLayout()
        layout.addWidget(self.play_button)
        layout.addWidget(self.play_endlessly_button)
        self.setLayout(layout)

        self.play_button.clicked.connect(self.play_once)
        self.play_endlessly_button.clicked.connect(self.play_endlessly)

    def play_once(self):
        self.player.setLoops(QMediaPlayer.Loops.Once)
        if self.player.mediaStatus() == QMediaPlayer.MediaStatus.LoadedMedia:
            # 若正在播放，先停止再重新播放（可选，根据需求调整）
            if self.player.playbackState() == QMediaPlayer.PlaybackState.PlayingState:
                self.player.stop()
            self.player.play()

    def play_endlessly(self):
        self.player.setLoops(QMediaPlayer.Loops.Infinite)
        if self.player.mediaStatus() == QMediaPlayer.MediaStatus.LoadedMedia:
            if self.player.playbackState() == QMediaPlayer.PlaybackState.PlayingState:
                self.player.stop()
            self.player.play()

    def _handle_media_error(self, error, error_string):
        print(f"媒体播放错误: {error_string}")

if __name__ == '__main__':
    app = QApplication([])
    widget = SoundPlayer()
    widget.show()
    sys.exit(app.exec())

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