이 페이지에서

cameraDevice QML Value Type

카메라 장치를 설명합니다. 더 보기...

Import Statement: import QtMultimedia
In C++: QCameraDevice

속성

상세 설명

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에서 0이 아닐 수 있는데, 이는 Android에서 기본 방향과 카메라 방향이 제조사에 의해 정의되기 때문입니다.

90도 \a 교정각이 적용된 예시

이 속성은 Qt 6.7에서 도입되었습니다.

description : string [read-only]

카메라의 사람이 읽을 수 있는 이름을 저장합니다.

이 문자열을 사용하여 사용자에게 장치를 표시합니다.

id : string [read-only]

카메라의 장치 ID를 저장합니다.

이는 카메라를 식별하기 위한 고유 ID이며, 사람이 읽을 수 있는 형식이 아닐 수 있습니다.

isDefault : bool [read-only]

이것이 기본 카메라 장치인 경우 true입니다.

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.