cameraDevice QML Value Type

カメラデバイスを記述する。詳細...

Import Statement: import QtMultimedia

プロパティ

詳細説明

cameraDevice 値タイプは、システムに接続されているカメラデバイスのプロパティを記述します。

cameraDeviceインスタンスは、対応する物理デバイスが切断されたり、設定が変更されたりしても、その寿命を通じてそのプロパティを保持します。更新されたプロパティを追跡するには、関連する信号が発生したときに、MediaDevices から cameraDevice の新しいインスタンスをロードする必要があります。

カメラ・デバイスのリストは、MediaDevices タイプからクエリできます。特定のカメラ・デバイスを選択するには、Camera のデバイスとして設定します。

CaptureSession {
    camera: Camera {
        cameraDevice: mediaDevices.defaultVideoInput
    }
}
MediaDevices {
    id: mediaDevices
}

プロパティの説明

correctionAngle : QtVideo::Rotation [since 6.7]

カメラの物理的な回転を補正するために必要な回転角度を返します。言い換えると、このプロパティは、出力画像をデバイスの画面上でネイティブな向きで直立させるために必要な時計回りの角度を表します。correctionAngle はネイティブの向きに対する相対的なものであるため、この値はデバイスの向き(ポートレート/ランドスケープ)を変えても変化しません。ネイティブの向きとカメラの向きがメーカーによって定義されている Android では、補正角度が 0 以外になることがあります。

補正角度90度の例

このプロパティは Qt 6.7 で導入されました。


description : string

人間が読めるカメラの名前を保持します。

この文字列を使用して、ユーザにデバイスを表示します。


id : string

カメラのデバイスIDを保持します。

これはカメラを識別するためのユニークなIDで、人間が読めるものではありません。


isDefault : bool

デフォルトのカメラデバイスの場合、trueを返します。


position : enumeration

ハードウェアシステム上のカメラの物理的な位置を返します。

返される値は以下のいずれかです:

定数説明
cameraDevice.UnspecifiedPositionカメラの位置は指定されていないか不明です。
cameraDevice.BackFaceカメラはシステムハードウェアの裏面にある。例えば、モバイルデバイスでは、画面の反対側にあることを意味します。
cameraDevice.FrontFaceカメラがシステムハードウェアの前面にある。例えばモバイル機器では、画面と同じ側にあることを意味する。前面カメラのプレビューは、ビデオ出力をミラーとして表示するために、垂直軸を中心に反転されます。

videoFormats : CameraFormat

カメラでサポートされているビデオフォーマットを保持します。


© 2025 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.