如何使用Python PyQt5实现网络MP3音乐的流式播放

问题根因 #

• 你现有代码使用的QAudioOutput仅支持播放原始PCM音频数据，本身不具备MP3解码能力，因此无法直接通过设置codec参数支持MP3格式
• PyQt的QAudioFormat仅用于描述PCM音频的参数，没有内置MPEG-3解码模块，所以你没法直接配置MP3 codec

可行方案（两种可选） #

方案1：使用QMediaPlayer直接实现流式播放（最简方案） #

这个方案不需要自己处理流下载和解码，Qt的多媒体框架会自动处理流缓冲、解码、播放的全流程，代码量极小，兼容绝大多数系统环境：

from PyQt5.QtWidgets import QApplication
from PyQt5.QtCore import QUrl
from PyQt5.QtMultimedia import QMediaPlayer, QMediaContent

if __name__ == "__main__":
    app = QApplication([])
    player = QMediaPlayer()
    # 填入你的MP3网络地址
    media = QMediaContent(QUrl("https://你的-mp3-地址.mp3"))
    player.setMedia(media)
    # 直接调用play就会边缓冲边播放，不需要等完整下载
    player.play()
    app.exec_()

注意事项：

• 首次播放会有1-3秒的缓冲等待，属于正常逻辑
• 若出现格式不支持的报错，检查系统是否安装了MP3解码器（Windows/macOS默认自带，Linux可安装gstreamer的bad/ugly插件包）

方案2：自主解码MP3流+QAudioOutput播放（可控度更高） #

如果需要自己控制下载流程、缓冲逻辑，就用pyav库（FFmpeg的Python绑定）将下载的MP3流实时解码为PCM数据，再喂给你原来用的QAudioOutput播放：
首先安装依赖：pip install pyav
实现代码如下：

from PyQt5.QtWidgets import QApplication
from PyQt5.QtCore import QBuffer
from PyQt5.QtMultimedia import QAudioFormat, QAudioOutput
import av
import urllib.request
import threading

class MP3Streamer:
    def __init__(self, url):
        # 初始化音频格式，和MP3解码后的PCM参数匹配
        self.format = QAudioFormat() 
        self.format.setSampleRate(44100) # 大部分MP3是44100采样率，可根据实际流调整
        self.format.setChannelCount(2)
        self.format.setSampleSize(16)
        self.format.setCodec("audio/pcm")
        self.format.setByteOrder(QAudioFormat.LittleEndian)
        self.format.setSampleType(QAudioFormat.SignedInt)
        self.audio = QAudioOutput(self.format)
        self.buffer = QBuffer()
        self.buffer.open(QBuffer.ReadWrite)
        
        # 启动下载解码线程
        self.url = url
        threading.Thread(target=self._stream_decode, daemon=True).start()
        self.audio.start(self.buffer)
    
    def _stream_decode(self):
        # 打开网络流
        web = urllib.request.urlopen(self.url)
        # 用av打开流，不需要下载完整文件
        container = av.open(web)
        # 找到音频流
        audio_stream = next(s for s in container.streams if s.type == 'audio')
        # 逐帧解码
        for frame in container.decode(audio_stream):
            # 将解码后的PCM数据转成bytes写入缓冲区
            pcm_data = frame.to_ndarray().tobytes()
            # 防止缓冲区溢出，等待音频播放一部分再写
            while self.buffer.size() > 1024*1024:
                threading.Event().wait(0.1)
            self.buffer.buffer().append(pcm_data)

if __name__ == "__main__":
    app = QApplication([])
    streamer = MP3Streamer("https://你的-mp3-地址.mp3")
    app.exec_()

注意事项：

• 可根据实际MP3流的采样率、声道数调整QAudioFormat的参数，避免播放声音失真
• 缓冲区大小可以根据你的需求调整，平衡播放延迟和抗网络波动能力

内容的提问来源于stack exchange，提问作者David john Gamer