cameraDevice QML Value Type
描述了一个摄像头设备。更多...
| Import Statement: | import QtMultimedia |
| In C++: | QCameraDevice |
属性
- correctionAngle : QtVideo::Rotation
(since 6.7) - description : string
- id : string
- isDefault : bool
- position : enumeration
- videoFormats : CameraFormat
详细说明
cameraDevice 值类型描述了连接到系统的摄像头设备的属性。
cameraDevice 实例在其生命周期内始终保留其属性,即使相应的物理设备已断开连接或其设置已被修改。为了跟踪更新的属性,用户应在相关信号触发时,从 `MediaDevices ` 加载新的 cameraDevice 实例。
可以对两个 `cameraDevice` 实例进行相等性比较。如果它们代表同一台物理设备,则被视为相等,无论其属性是否相同或是否为最新状态。
可通过MediaDevices 类型查询相机设备列表。要选择特定的相机设备,请将其设置为Camera 中的设备。
CaptureSession {
camera: Camera {
cameraDevice: mediaDevices.defaultVideoInput
}
}
MediaDevices {
id: mediaDevices
}属性文档
correctionAngle : QtVideo::Rotation [read-only, since 6.7]
返回用于补偿相机相对于其原生方向的物理旋转所需的旋转角度。换言之,该属性表示输出图像需要顺时针旋转的角度,以便在设备屏幕上以原生方向正立显示。 由于 `correctionAngle ` 是相对于原生方向的,因此该值不会因设备方向(纵向/横向)的改变而变化。该校正角度主要在 Android 系统上可能不为零,因为在该系统中,原生方向和相机方向由制造商定义。

该属性于 Qt 6.7 版本中引入。
description : string [read-only]
存储摄像头的可读名称。
使用此字符串向用户展示该设备。
id : string [read-only]
包含相机的设备 ID
这是一个用于识别摄像头的唯一标识符,可能无法被人类直接识别。
isDefault : bool [read-only]
如果这是默认的摄像头设备,则为真。
position : enumeration [read-only]
返回相机在硬件系统上的物理位置。
返回值可以是以下之一:
| 常量 | 描述 |
|---|---|
cameraDevice.UnspecifiedPosition | 相机位置未指定或未知。 |
cameraDevice.BackFace | 摄像头位于系统硬件的背面。例如在移动设备上,这意味着它位于与屏幕相对的一侧。 |
cameraDevice.FrontFace | 摄像头位于系统硬件的正面。例如在移动设备上,这意味着它与屏幕位于同一侧。前置摄像头的预览画面会沿垂直轴翻转,以镜像形式显示视频输出,但在录制过程中不会进行此翻转操作。 |
videoFormats : CameraFormat [read-only]
列出了该相机支持的视频格式。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.