PyQt5使用QMediaPlayer播放RTSP H264视频流卡顿如何修复

QMediaPlayer默认网络缓冲阈值较低，且默认系统多媒体后端对RTSP流适配较差，是卡顿的核心原因，可通过以下方法解决：

方法1：调整内置网络缓冲参数 #

Qt Multimedia自带可配置的网络缓存机制，类似VLC的网络缓存设置，修改缓冲阈值即可大幅改善卡顿，完整修改后代码如下：

import sys
import os
from PyQt5 import QtCore, QtWidgets
from PyQt5.QtMultimedia import QMediaPlayer, QMediaContent, QMediaNetworkAccessControl
from PyQt5.QtMultimediaWidgets import QVideoWidget

# 可选：如果安装了GStreamer可取消注释启用该后端，流畅度更高
# os.environ["QT_MEDIA_BACKEND"] = "gstreamer"

class Player(QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Media Player")
        self.mediaPlayer = QMediaPlayer(None, QMediaPlayer.VideoSurface)
        self.mediaPlayer.error.connect(self.handle_error)

        # 配置网络缓冲参数
        net_control = self.mediaPlayer.service().requestControl("org.qt-project.qt.medianetworkaccesscontrol/5.0")
        if isinstance(net_control, QMediaNetworkAccessControl):
            # 设置缓存时长，单位ms，建议1000-3000之间，数值越高越流畅但延迟越大
            net_control.setBufferRange(QtCore.QMediaTimeRange(0, 2000))
            # 缓冲完成80%以上才开始播放，避免中途卡顿
            net_control.setMinimumBufferProgress(80)

        self.videowidget = QVideoWidget()
        self.mediaPlayer.setMedia(QMediaContent(QtCore.QUrl("rtsp://<address>:<port>")))
        self.mediaPlayer.setVideoOutput(self.videowidget.videoSurface())
        self.mediaPlayer.play()

        main_lay = QtWidgets.QVBoxLayout()
        main_lay.addWidget(self.videowidget)
        self.setLayout(main_lay)

    def handle_error(self):
        print("Error: " + self.mediaPlayer.errorString())

if __name__ == "__main__":
    app = QtWidgets.QApplication(sys.argv)
    player = Player()
    player.show()
    player.resize(640, 480)
    sys.exit(app.exec_())

方法2：更换为GStreamer后端 #

Windows默认的DirectShow、macOS默认的AVFoundation后端对RTSP的支持都比较差，换成GStreamer后端后，RTSP处理逻辑和VLC同源，流畅度接近VLC：

• 先安装对应系统版本的GStreamer运行库，安装时勾选RTSP相关插件
• 启动程序前添加对应环境变量设置即可启用

方法3：自定义拉流解码逻辑 #

如果以上方法仍无法满足需求，可以用ffmpeg-python或OpenCV直接拉RTSP流，自己维护帧缓存队列，解码后转成QImage绘制到界面，完全自主控制缓存大小，既可以达到VLC的流畅度，也可以保留所有自定义功能。

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