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 の新しいインスタンスをロードする必要があります。
2つのcameraDeviceインスタンスは等しいかどうか比較できます。プロパティが等しいか最新であるかに関係なく、同じ物理デバイスを表していれば等しいと見なされます。
カメラ・デバイスのリストはMediaDevices タイプから取得できます。特定のカメラ・デバイスを選択するには、Camera のデバイスとして設定します。
CaptureSession {
camera: Camera {
cameraDevice: mediaDevices.defaultVideoInput
}
}
MediaDevices {
id: mediaDevices
}プロパティのドキュメント
correctionAngle : QtVideo::Rotation [read-only, since 6.7]
カメラの物理的な回転を補正するために必要な回転角度を返します。言い換えると、このプロパティは、ネイティブの向きでデバイスの画面上に直立するために出力画像を回転させる必要がある時計回りの角度を表します。correctionAngle はネイティブの向きに対する相対的なものであるため、この値はデバイスの向き(ポートレート/ランドスケープ)を変えても変化しません。ネイティブの向きとカメラの向きがメーカーによって定義されている Android では、補正角度が 0 以外になることがあります。

このプロパティは Qt 6.7 で導入されました。
description : string [read-only]
カメラの可読形式の名前を保持します。
この文字列を使用して、ユーザにデバイスを表示します。
id : string [read-only]
カメラのデバイスIDを保持します。
これはカメラを識別するためのユニークな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.