OutputConfiguration.StreamUseCase プロパティ

定義

名前空間:

Android.Hardware.Camera2.Params

アセンブリ:

Mono.Android.dll

現在のストリームのユース ケースを取得します。または、この OutputConfiguration のストリームユース ケースを設定します

public long StreamUseCase { [Android.Runtime.Register("getStreamUseCase", "()J", "", ApiSince=33)] get; [Android.Runtime.Register("setStreamUseCase", "(J)V", "", ApiSince=33)] set; }

[<get: Android.Runtime.Register("getStreamUseCase", "()J", "", ApiSince=33)>]
[<set: Android.Runtime.Register("setStreamUseCase", "(J)V", "", ApiSince=33)>]
member this.StreamUseCase : int64 with get, set

プロパティ値

Int64

現在設定されているストリームのユース ケース

属性

RegisterAttribute

注釈

プロパティ getter のドキュメント:

現在のストリームのユース ケースを取得する

最初に呼び出されない#setStreamUseCase場合、この関数は .CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES_DEFAULT DEFAULT

の Java ドキュメントandroid.hardware.camera2.params.OutputConfiguration.getStreamUseCase()

プロパティ セッターのドキュメント:

この OutputConfiguration のストリーム ユース ケースを設定する

ストリームのユース ケースは、ライブ プレビュー、静止画像キャプチャ、ビデオ録画、またはその組み合わせに関係なく、ストリームの目的を記述するために使用されます。 このフラグは、即時コンシューマー ターゲットがストリームの使用状況を示すには不十分なシナリオに役立ちます。

ストリームのユース ケースとキャプチャの意図の主な違いは、前者は、カメラ デバイスが各ストリームのユーザー シナリオに基づいてカメラ ハードウェアとソフトウェア パイプラインを最適化できるのに対し、後者は主に、セッション全体に適用できる最適な 3A 戦略を決定するためのカメラへのヒントです。 カメラ デバイスは、チューニング パラメーターの選択、カメラ センサー モードの選択、ストリームのユース ケースに基づく画像処理パイプラインの構築などの構成を実行します。 キャプチャインテントは、AE/AF収束速度の調整などの3A動作を微調整するために使用され、キャプチャ意図はセッションの有効期間中に変更される可能性があります。 たとえば、PREVIEW_VIDEO_STILLユース ケース ストリームとSTILL_CAPTUREユース ケース ストリームを使用したセッションの場合、キャプチャの意図は、ライブ プレビュー用の自動制御による高速な 3A 収束速度とフラッシュ メータリングを使用したプレビュー、写真キャプチャに最適な 3A パラメーターのSTILL_CAPTURE、ビデオ再生エクスペリエンスを向上するために 3A の収束速度が遅いVIDEO_RECORDなどです。

カメラ デバイスでサポートされているサポートされているストリームのユース ケースは、次の方法で android.hardware.camera2.CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES照会できます。

ストリームのユース ケースに関連する必須のストリームの組み合わせは、クエリを使用してandroid.hardware.camera2.params.MandatoryStreamCombination検索android.hardware.camera2.CameraDevice#createCaptureSessionすることもできます。 アプリケーションでは、すべてのストリームのユース ケースが DEFAULT 以外の値に設定されている、保証されたストリームの組み合わせのいずれかを選択することを強くお勧めします。 アプリケーションが必須リストにないストリームの組み合わせを選択した場合、カメラ デバイスはハードウェアの制約や実装の詳細のためにいくつかのユース ケース フラグを無視する可能性があります。

この関数は、次の前またはCameraDevice#createCaptureSessionByOutputConfigurations前にCameraDevice#createCaptureSession呼び出す必要があります。 カメラ セッションの後 CameraDevice#createCaptureSession で CameraDevice#createCaptureSessionByOutputConfigurations この関数を呼び出すか、または効果がありません。

の Java ドキュメントandroid.hardware.camera2.params.OutputConfiguration.setStreamUseCase(long)

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。