如何在PyQt5应用中流式播放Azure Blob Storage中的视频（无需本地下载）

问题核心 #

直接读取Azure Blob内容到内存后用QBuffer播放失败，主要原因是QBuffer生命周期管理不当（函数内创建的局部buffer会被垃圾回收），以及未正确绑定QMediaPlayer与IO设备。

修正后的可运行代码 #

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton, QVBoxLayout, QWidget
from PyQt5.QtMultimedia import QMediaPlayer, QMediaContent
from PyQt5.QtMultimediaWidgets import QVideoWidget
from PyQt5.QtCore import QBuffer, QIODevice
from azure.storage.blob import BlobServiceClient

class VideoPlayerWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        # Azure Blob配置
        connection_string = "你的Azure存储账户连接字符串"
        self.blob_service_client = BlobServiceClient.from_connection_string(connection_string)
        self.container_name = "testing"
        self.video_path = "video/short-test-92734b6d9f2e/out_0.mp4"

        # 窗口基础设置
        self.setWindowTitle("Azure视频播放器")
        self.setGeometry(100, 100, 800, 600)

        # 布局与控件创建
        layout = QVBoxLayout()
        self.video_widget = QVideoWidget()
        layout.addWidget(self.video_widget)

        self.play_button = QPushButton("播放")
        self.play_button.clicked.connect(self.play_video)
        layout.addWidget(self.play_button)

        central_widget = QWidget()
        central_widget.setLayout(layout)
        self.setCentralWidget(central_widget)

        # 媒体播放器初始化
        self.media_player = QMediaPlayer(None, QMediaPlayer.VideoSurface)
        self.media_player.setVideoOutput(self.video_widget)
        self.media_player.error.connect(self.handle_media_error)
        
        # 类成员变量：保存视频缓冲区，避免函数执行后被回收
        self.video_buffer = QBuffer()

    def play_video(self):
        # 从Azure Blob读取视频内容到内存
        blob_client = self.blob_service_client.get_blob_client(container=self.container_name, blob=self.video_path)
        video_data = blob_client.download_blob().readall()

        # 初始化缓冲区并设置只读模式
        self.video_buffer.setData(video_data)
        self.video_buffer.open(QIODevice.ReadOnly)

        # 绑定媒体播放器与缓冲区
        self.media_player.setMedia(QMediaContent(), self.video_buffer)
        self.media_player.play()

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

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = VideoPlayerWindow()
    window.show()
    sys.exit(app.exec_())

关键说明 #

1. 缓冲区生命周期：将QBuffer定义为类成员变量，而非play_video内的局部变量，确保媒体播放期间缓冲区不会被Python垃圾回收。
2. 媒体绑定方式：使用setMedia(QMediaContent(), buffer)传入IO设备，而非通过URL——因为内存中的视频没有对应的本地/网络地址，直接绑定IO设备是正确的做法。
3. 大视频优化：如果视频文件较大，一次性readall()会占用过多内存，可自定义继承QIODevice的类，实现从Azure Blob分块读取的流式加载逻辑，避免内存溢出。

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