QCameraDevice 类

QCameraDevice 类提供有关相机设备的一般信息。更多...

头部	#include <QCameraDevice>
CMake	find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia)
qmake	QT += multimedia

所有成员列表，包括继承的成员

公共类型

枚举	Position { 未指定位置，背面，正面 }

属性

(自 6.7) correctionAngle : const QtVideo::Rotation
description : const QString
id : const QByteArray

isDefault : const bool
position : const Position
videoFormats : const QList<QCameraFormat>

公共函数

	QCameraDevice()
	QCameraDevice(const QCameraDevice &other)
	~QCameraDevice()
QtVideo::Rotation	correctionAngle() const
QString	description() const
QByteArray	id() const
bool	isDefault() const
bool	isNull() const
QList<QSize>	photoResolutions() const
QCameraDevice::Position	position() const
QList<QCameraFormat>	videoFormats() const
bool	operator!=(const QCameraDevice &other) const
QCameraDevice &	operator=(const QCameraDevice &other)
bool	operator==(const QCameraDevice &other) const

详细描述

QCameraDevice 表示物理相机设备和其属性。

您可以使用可用的相机和默认相机函数发现系统上可用的相机。这些包含在 QtMultimedia::MediaDevices 中。

以下示例打印所有可用相机的名称

const QList<QCameraDevice> cameras = QMediaDevices::videoInputs();
for (const QCameraDevice &cameraDevice : cameras)
    qDebug() << cameraDevice.description();

可以使用 QCameraDevice 创建 QCamera。以下示例实例化一个名为 mycamera 的 QCamera

const QList<QCameraDevice> cameras = QMediaDevices::videoInputs();
for (const QCameraDevice &cameraDevice : cameras) {
    if (cameraDevice.description() == "mycamera")
        camera = new QCamera(cameraDevice);
}

您还可以使用 QCameraDevice 获取有关相机设备的一般信息，例如描述和系统上的物理位置。

QCamera myCamera;
QCameraDevice cameraDevice = camera->cameraDevice();

if (cameraDevice.position() == QCameraDevice::FrontFace)
    qDebug() << "The camera is on the front face of the hardware system.";
else if (cameraDevice.position() == QCameraDevice::BackFace)
    qDebug() << "The camera is on the back face of the hardware system.";

另请参阅QCamera.

成员类型文档

枚举 QCameraDevice::Position

该枚举指定了相机在系统硬件上的物理位置。

常量	值	描述
`QCameraDevice::UnspecifiedPosition`	`0`	相机位置未指定或未知。
`QCameraDevice::BackFace`	`1`	相机位于系统硬件的后面。例如，在移动设备上，这意味着它位于屏幕的对面。
`QCameraDevice::FrontFace`	`2`	相机位于系统硬件的前面。例如，在移动设备上，这意味着它位于屏幕的同侧。

另请参阅位置。

属性文档

`[只读，自6.7版起]` correctionAngle : const QtVideo::Rotation

返回用于补偿相机相对于其原始方向的物理旋转所需的旋转角度。换句话说，该属性表示输出图像需要顺时针旋转多少角度以达到设备屏幕上其原始方向的直立状态。由于correctionAngle是相对于原始方向，因此该值不会随着设备方向的更改（纵向/横向）而改变。校正角度在Android上可能非零，因为原始方向和相机方向由制造商定义。

$Example with 90 degrees \a correctionAngle$

此属性是在Qt 6.7中引入的。

访问函数

QtVideo::Rotation correctionAngle() const

`[只读]` description : const QString

返回相机的供人类阅读的描述。

使用此字符串向用户展示设备。

访问函数

QString description() const

`[只读]` id : const QByteArray

返回相机的设备ID。

这是用于识别相机的唯一ID，可能不是人类可读的。

访问函数

QByteArray id() const

`[只读]` isDefault : const bool

如果这是默认相机设备，则返回true。

访问函数

bool	isDefault() const

`[只读]` position : const Position

返回相机在硬件系统上的物理位置。

访问函数

QCameraDevice::Position position() const

`[只读]` videoFormats : const QList<QCameraFormat>

返回相机支持的视频格式。

访问函数

QList<QCameraFormat> videoFormats() const

成员函数文档

QCameraDevice::QCameraDevice()

构建一个空相机设备

QCameraDevice::QCameraDevice(const QCameraDevice &other)

构建other的一个副本。

`[noexcept]` QCameraDevice::~QCameraDevice()

销毁QCameraDevice。

bool QCameraDevice::isNull() const

如果此 QCameraDevice 对象为空或无效，则返回 true。

QList<QSize> QCameraDevice::photoResolutions() const

返回相机可用以捕获静态图像的分辨率列表。

另请参阅QImageCapture.

bool QCameraDevice::operator!=(const QCameraDevice &other) const

如果此 QCameraDevice 与其他不同，则返回 true。

QCameraDevice &QCameraDevice::operator=(const QCameraDevice &other)

将 QCameraDevice 对象设置为等于其他。

bool QCameraDevice::operator==(const QCameraDevice &other) const

如果此 QCameraDevice 等于其他，则返回 true。

QCameraDevice 类

公共类型

属性

公共函数

详细描述

成员类型文档

枚举 QCameraDevice::Position

属性文档

[只读，自6.7版起] correctionAngle : const QtVideo::Rotation

[只读] description : const QString

[只读] id : const QByteArray

[只读] isDefault : const bool

[只读] position : const Position

[只读] videoFormats : const QList<QCameraFormat>

成员函数文档

QCameraDevice::QCameraDevice()

QCameraDevice::QCameraDevice(const QCameraDevice &other)

[noexcept] QCameraDevice::~QCameraDevice()

bool QCameraDevice::isNull() const

QList<QSize> QCameraDevice::photoResolutions() const

bool QCameraDevice::operator!=(const QCameraDevice &other) const

QCameraDevice &QCameraDevice::operator=(const QCameraDevice &other)

bool QCameraDevice::operator==(const QCameraDevice &other) const

`[只读，自6.7版起]` correctionAngle : const QtVideo::Rotation

`[只读]` description : const QString

`[只读]` id : const QByteArray

`[只读]` isDefault : const bool

`[只读]` position : const Position

`[只读]` videoFormats : const QList<QCameraFormat>

`[noexcept]` QCameraDevice::~QCameraDevice()