言語

ControlSceneMode 列挙型

定義

ControlSceneModeのいくつかのメソッドによって返される値を列挙します。

public enum ControlSceneMode
type ControlSceneMode = 
継承
ControlSceneMode

フィールド

名前 説明
Disabled 0

特定のキャプチャ要求に対してシーン モードが設定されていないことを示します。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_DISABLEDの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

FacePriority 1

顔検出のサポートが存在する場合は、自動フォーカス、自動ホワイト バランス、自動露出ルーチンに顔検出データを使用します。

顔検出の統計情報が無効になっている場合 (つまり、android.statistics.faceDetectMode が OFF に設定されている場合)、これは正しく動作するはずです (ただし、顔検出の統計情報はフレームワークに返されません)。

他のシーン モードとは異なり、android.control.aeMode、android.control.awbMode、android.control.afMode は、FACE_PRIORITYが設定されているとアクティブなままです。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_FACE_PRIORITYの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Action 2

すばやく移動するオブジェクトの写真用に最適化されています。

スポーツに似ています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_ACTIONの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Portrait 3

人の静止写真用に最適化されています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_PORTRAITの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Landscape 4

遠くのマクロスコープオブジェクトの写真用に最適化されています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_LANDSCAPEの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Night 5

ローライト設定用に最適化されています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_NIGHTの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

NightPortrait 6

ローライト設定のユーザーの静止写真用に最適化されています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_NIGHT_PORTRAITの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Theatre 7

フラッシュをオフのままにする必要がある暗い屋内設定用に最適化されています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_THEATREの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Beach 8

明るく屋外のビーチ設定用に最適化されています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_BEACHの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Snow 9

雪を含む明るく屋外の設定に最適化されています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_SNOWの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Sunset 10

設定日のシーンに合わせて最適化されています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_SUNSETの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Steadyphoto 11

少量のデバイスモーション(手の振れなど)によるぼやけた写真を避けるために最適化されています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_STEADYPHOTOの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Fireworks 12

花火の夜間の写真のために最適化されています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_FIREWORKSの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Sports 13

すばやく移動する人の写真用に最適化されています。

ACTION に似ています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_SPORTSの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Party 14

複数の人が動いている暗い、屋内の設定のために最大限に活用される。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_PARTYの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Candlelight 15

主な光源がキャンドルである暗い設定のために最大限に活用される。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_CANDLELIGHTの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Barcode 16

バーコード値を読み取りたいカメラアプリケーションで使用するために、バーコードの写真を正確にキャプチャするために最適化されています。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_BARCODEの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

HighSpeedVideo 17

この定数は、API レベル 23 では非推奨になりました。 代替手段を見つけるには、この API ドキュメントを参照してください

これは非推奨です。CameraDevice.createConstrainedHighSpeedCaptureSession(List, StateCallback, Handler) と CameraConstrainedHighSpeedCaptureSession.createHighSpeedRequestList(CaptureRequest) を使用して高速ビデオ記録を行ってください。

高速ビデオ記録 (フレーム レート >= 60fps) ユース ケース用に最適化されています。

サポートされている高速ビデオ サイズと fps 範囲は、android.control.availableHighSpeedVideoConfigurations で指定されています。 目的の出力フレーム レートを取得するために、アプリケーションでは、この静的メタデータに記載されているビデオ サイズと fps 範囲の組み合わせを選択することのみが許可されます。 fps 範囲は、android.control.aeTargetFpsRange を使用して制御できます。

このモードでは、カメラ デバイスは aeMode、awbMode、afMode をそれぞれ ON、ON、および CONTINUOUS_VIDEO にオーバーライドします。 すべての後処理ブロック モード コントロールは、FAST にオーバーライドされます。 そのため、キャプチャと後処理のパラメーターを手動で制御できません。 他のすべてのコントロールは、android.control.mode == AUTO の場合と同じように動作します。 これは、他のすべての android.control.* フィールドが引き続き動作することを意味します。android.control.aeTargetFpsRange;android.control.aeExposureCompensation;android.control.aeLock;android.control.awbLock;android.control.effectMode;android.control.aeRegions;android.control.afRegions;android.control.awbRegions;android.control.afTrigger;android.control.aePrecaptureTrigger;android.control.zoomRatio

android.control.*の外部では、次のコントロールが機能します:android.flash.mode (aeMode が ON であるため、まだキャプチャするための自動フラッシュは機能しません)。android.lens.opticalStabilizationMode (サポートされている場合)android.scaler.cropRegion;android.statistics.faceDetectMode

高速記録のユース ケースの場合、実際にサポートされている最大フレーム レートは、画像データの宛先サーフェスに応じて、カメラが出力できるフレーム レートよりも低くなる場合があります。 たとえば、宛先サーフェスがビデオ エンコーダーからのものである場合、アプリケーションでは、ビデオ エンコーダーが特定のビデオ サイズに対して高いフレーム レートをサポートできるかどうかを確認する必要があります。そうしないと、最終的に記録フレーム レートが低くなります。 ターゲット サーフェスがプレビュー ウィンドウの場合、プレビュー フレーム レートは画面のリフレッシュ レートによって制限されます。

カメラ デバイスは、このモードで最大 2 つの出力高速ストリーム (android.request.maxNumOutputStreams で定義された非ストール形式で処理) のみをサポートします。 このコントロールは、以下の条件がすべて満たされている場合にのみ有効です。maxNumHighSpeedStreams が非ストール形式の出力ストリームを処理し、maxNumHighSpeedStreams は min(2, android.request.maxNumOutputStreams[Processed (but not-stalling)]) として計算されます。ストリーム サイズは、android.control.availableHighSpeedVideoConfigurations によって報告されるサイズから選択されます。処理された非ストールストリームまたは生ストリームが構成されていない

上記の条件が満たされていない場合、このモードと android.control.aeTargetFpsRange のコントロールはカメラ デバイスによって無視され、カメラ デバイスは android.control.mode == AUTO にフォールバックし、返されるキャプチャ結果メタデータはカメラ デバイスによって選択された fps 範囲を提供します。

このモードに切り替えたり、切り替えたりすると、一部のカメラ ISP/センサー再構成がトリガーされ、待機時間が長くなる可能性があります。 アプリケーションでは、不要なシーン モード切り替えを可能な限り回避することをお勧めします。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_HIGH_SPEED_VIDEOの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Hdr 18

デバイス固有のハイ ダイナミック レンジ (HDR) モードをオンにします。

このシーン モードでは、カメラ デバイスは、より広い範囲のシーン イルミネーション レベルを最終的な画像に表示する画像をキャプチャします。 たとえば、明るいウィンドウの前でオブジェクトを撮影する場合、HDR モードを使用している場合は、オブジェクトとシーンの両方が表示され、通常の AUTO モードでは、一方または他のオブジェクトの露出が低下する可能性があります。 トレードオフとして、HDR モードでは通常、1 つの画像のキャプチャにはるかに時間がかかり、ユーザーコントロールがなく、使用される HDR 方法によっては他のアーティファクトが存在する可能性があります。

そのため、HDR キャプチャは通常のキャプチャよりもはるかに低速な速度で動作します。

このモードでは、LIMITED デバイスまたは FULL デバイスで、STILL_CAPTUREの android.control.captureIntent で要求が行われると、カメラ デバイスは高ダイナミック レンジ キャプチャ手法を使用して画像をキャプチャします。 LEGACY デバイスでは、JPEG 形式の出力をターゲットとするキャプチャは HDR でキャプチャされ、キャプチャの意図は関係ありません。

HDR キャプチャには、デバイスが内部的にイメージのバーストをキャプチャして 1 つに結合する場合や、特殊化された高ダイナミック レンジ キャプチャ ハードウェアを使用するデバイスが含まれる場合があります。 いずれの場合も、HDR モード中に送信されたキャプチャ要求に応答して、1 つの画像が生成されます。

一般に HDR イメージを生成するには大量の後処理が必要であるため、制限付き/完全デバイス HDR キャプチャでは YUV、PRIVATE、JPEG 出力のみがサポートされ、LEGACY HDR キャプチャでは JPEG 出力のみがサポートされます。 HDR キャプチャに RAW 出力を使用することはサポートされていません。

一部のデバイスでは、フル フレーム レートで HDR 処理を適用する常時オン HDR もサポートされる場合があります。 これらのデバイスでは、STILL_CAPTURE以外の意図でも、通常の操作と比較してフレーム レートに影響を与える HDR 出力が生成されますが、品質はSTILL_CAPTUREの意図よりも低くなる可能性があります。

サポートされていない出力の種類またはキャプチャ意図でSCENE_MODE_HDRが使用されている場合、キャプチャされたイメージは、SCENE_MODEがまったく有効になっていないかのように表示されます。

android.hardware.camera2.CameraMetadata.CONTROL_SCENE_MODE_HDRの Android リファレンス。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

注釈

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象