qt QCamera详解

1. 概述

QCamera是Qt框架提供的一个模块，用于在Windows、MacOS和Linux平台上开发多媒体应用。它提供了一个高级的界面和易于使用的API，使开发人员能够快速有效地构建各种多媒体应用程序，如拍照、录像、视频流播放和背景录制等。QCamera还支持相机设备的控制，如自动调焦、曝光和图像稳定等高级特性。

2. 重要方法

QCamera类提供了一系列重要的方法，用于访问和控制摄像头设备。以下是一些常用的方法：

构造函数和析构函数：
- QCamera(QObject* parent = nullptr)：构造一个QCamera对象，可选参数parent指定了父对象，默认为nullptr。
- ~QCamera()：析构函数，用于释放QCamera对象。
设置和启动摄像头：
- void setCaptureMode(QCamera::CaptureModes mode)：设置摄像头的捕捉模式，可以是照片模式、视频模式或同时支持两种模式。
- bool start()：打开摄像头设备并开始捕捉视频帧或图像。
- bool stop()：停止捕捉视频或图像，并关闭摄像头设备。
预览和捕获：
- void setViewfinder(QAbstractVideoSurface* surface)：将预览窗口设置为指定的视频表面。
- void setViewfinder(QWidget* widget)：将预览窗口设置为指定的QWidget对象。
- void setViewfinderSettings(const QCameraViewfinderSettings& settings)：设置预览窗口的参数，如分辨率、帧率等。
- void capture()：捕捉当前预览窗口中的一帧图像。
- void setCaptureDestination(QCameraImageCapture::CaptureDestinations destination)：设置图像捕捉的目标位置，可以是文件、内存或其他自定义目标。
视频录制：
- void record()：开始录制视频。
- void stopRecording()：停止录制视频。
设备控制：
- void searchAndLock()：搜索当前系统上可用的摄像头设备，并锁定所选设备。
- QCameraExposure* exposure() const：获取相机的曝光控制对象（只读）。
- QCameraFocus* focus() const：获取相机的焦点控制对象（只读）。
- QCameraImageProcessing* imageProcessing() const：获取相机的图像处理控制对象（只读）。

3. 重要信号

QCamera类还提供了多个信号，用于管理和响应摄像头的状态变化。以下是一些常用的信号：

void statusChanged(QCamera::Status status)：当摄像头的状态发生变化时发出。
void error(int id, const QString &errorString)：当摄像头发生错误时发出。
void captureModeChanged(QCamera::CaptureModes mode)：当摄像头的捕获模式发生变化时发出。

通过连接这些信号到相应的槽函数，可以实现对摄像头操作的定制化响应。

4. 常用枚举类型

QCamera及其相关类使用了一些枚举类型来定义不同的参数和状态。以下是一些常用的枚举类型：

QCamera::CaptureModes：定义摄像头的捕捉模式，如照片模式、视频模式或同时支持两种模式。
QCamera::Status：定义摄像头的状态，如未连接、加载中、已连接和已停止等。
QCamera::LockTypes：定义摄像头支持的锁类型，如自动曝光锁、自动白平衡锁等。
QCamera::FrameRateRange：定义摄像头支持的帧率范围。

#include <QApplication>
#include <QMainWindow>
#include <QCamera>
#include <QCameraViewfinder>
#include <QCameraImageCapture>
#include <QVBoxLayout>
#include <QPushButton>class MainWindow : public QMainWindow {Q_OBJECTpublic:MainWindow(QWidget *parent = nullptr) : QMainWindow(parent) {// 创建相机对象camera = new QCamera(QCameraInfo::availableCameras().last());// 创建相机取景器对象viewfinder = new QCameraViewfinder(this);camera->setViewfinder(viewfinder);// 创建拍照按钮QPushButton *captureButton = new QPushButton("Capture", this);connect(captureButton, &QPushButton::clicked, this, &MainWindow::captureImage);// 设置布局QWidget *centralWidget = new QWidget(this);QVBoxLayout *layout = new QVBoxLayout(centralWidget);layout->addWidget(viewfinder);layout->addWidget(captureButton);setCentralWidget(centralWidget);// 启动相机camera->start();}~MainWindow() {delete camera;delete viewfinder;}private slots:void captureImage() {// 创建图像捕获对象QCameraImageCapture *imageCapture = new QCameraImageCapture(camera, this);connect(imageCapture, &QCameraImageCapture::imageSaved, this, &MainWindow::onImageSaved);// 捕捉图像imageCapture->capture();}void onImageSaved(int id, const QString &preview) {qDebug() << "Image saved:" << preview;// 在这里可以添加保存成功后的处理逻辑}private:QCamera *camera;QCameraViewfinder *viewfinder;
};int main(int argc, char *argv[]) {QApplication app(argc, argv);MainWindow window;window.show();return app.exec();
}