如何解决PyQt5使用QCamera调用摄像头无法正常拍照的问题

核心问题1：局部变量被提前回收 #

你当前代码里的camera和QCameraImageCapture实例都是clickphoto函数的局部变量，函数执行结束后会被Python垃圾回收机制销毁，此时摄像头还没完成拍照和文件写入流程，自然不会生成照片文件。

核心问题2：未等待摄像头就绪就触发拍照 #

QCamera启动需要几百毫秒的硬件初始化时间，你调用camera.start()后立刻执行capture()，此时摄像头还未进入就绪状态，无法完成拍照操作。

核心问题3：Windows平台Qt5媒体编码组件缺失 #

你看到的Unsupported media type警告是Qt5.15在Windows平台的常见问题，原因是系统缺少DirectShow框架下的JPEG编码组件，导致Qt多媒体模块无法直接输出JPG格式的图片。

步骤1：将摄像头相关实例改为类成员变量 #

避免局部变量被提前销毁，保证拍照流程能执行完成。

步骤2：添加信号监听 #

监听摄像头的状态变化信号，等摄像头完全启动后再执行拍照；同时监听拍照完成、报错信号，方便排查问题。

步骤3：修复编码警告 #

可以安装Windows平台通用解码包补全编码支持，也可以直接将输出格式改为PNG避免JPG编码依赖。

from PyQt5 import QtCore, QtGui, QtWidgets
from PyQt5.QtWidgets import *
from PyQt5.QtMultimedia import *
from PyQt5.QtMultimediaWidgets import *
import os
class Ui_MainWindow(object):
    def __init__(self):
        self.camera = None
        self.capture = None
        
    def on_camera_state_changed(self, state):
        # 摄像头启动完成后再拍照
        if state == QCamera.ActiveState:
            save_path = os.path.join(os.getcwd(), "999.png")
            self.capture.capture(save_path)
    
    def on_image_saved(self, id, path):
        print(f"照片已保存到：{path}")
        # 拍照完成后可以按需关闭摄像头
        self.camera.stop()
    
    def on_capture_error(self, id, error, error_str):
        print(f"拍照出错：{error_str}")
        
    def clickphoto(self):
        print("clickphoto Called !")
        available_cameras = QCameraInfo.availableCameras()
        if len(available_cameras)>0:
            print(available_cameras[0].description())
            try:
                self.camera = QCamera(available_cameras[0])
                self.camera.setCaptureMode(QCamera.CaptureStillImage)
                # 监听摄像头状态变化
                self.camera.stateChanged.connect(self.on_camera_state_changed)
                self.capture = QCameraImageCapture(self.camera)
                # 监听拍照保存完成和错误信号
                self.capture.imageSaved.connect(self.on_image_saved)
                self.capture.error.connect(self.on_capture_error)
                # 设置保存格式为PNG避免JPG编码问题
                self.capture.setCaptureDestination(QCameraImageCapture.CaptureToFile)
                self.camera.start()
            except Exception as e:
                print("Exception occured, ",e)
        else:
            print("Error")

    def setupUi(self, MainWindow):
        MainWindow.setObjectName("MainWindow")
        MainWindow.resize(251, 271)
        self.centralwidget = QtWidgets.QWidget(MainWindow)
        self.centralwidget.setObjectName("centralwidget")
        self.clickphotobtn = QtWidgets.QPushButton(self.centralwidget)
        self.clickphotobtn.setGeometry(QtCore.QRect(90, 110, 75, 23))
        self.clickphotobtn.setObjectName("clickphotobtn")

        # 点击事件绑定
        self.clickphotobtn.clicked.connect(self.clickphoto)

        MainWindow.setCentralWidget(self.centralwidget)
        self.menubar = QtWidgets.QMenuBar(MainWindow)
        self.menubar.setGeometry(QtCore.QRect(0, 0, 251, 23))
        self.menubar.setObjectName("menubar")
        MainWindow.setMenuBar(self.menubar)
        self.statusbar = QtWidgets.QStatusBar(MainWindow)
        self.statusbar.setObjectName("statusbar")
        MainWindow.setStatusBar(self.statusbar)

        self.retranslateUi(MainWindow)
        QtCore.QMetaObject.connectSlotsByName(MainWindow)

    def retranslateUi(self, MainWindow):
        _translate = QtCore.QCoreApplication.translate
        MainWindow.setWindowTitle(_translate("MainWindow", "MainWindow"))
        self.clickphotobtn.setText(_translate("MainWindow", "Capture"))


if __name__ == "__main__":
    import sys
    app = QtWidgets.QApplication(sys.argv)
    MainWindow = QtWidgets.QMainWindow()
    ui = Ui_MainWindow()
    ui.setupUi(MainWindow)
    MainWindow.show()
    sys.exit(app.exec_())

如果仍然需要输出JPG格式，安装Windows平台通用解码包即可解决Unsupported media type警告。如果条件允许，也可以升级到PyQt6，其多媒体模块进行了重构，Windows平台兼容性大幅提升，不会出现该类编码警告问题。

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