CameraDevice.CreateCaptureSession メソッド

定義

名前空間:: Android.Hardware.Camera2

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

名前	説明
CreateCaptureSession(SessionConfiguration)	サポートされているすべてのパラメーターを集計する`SessionConfiguration` ヘルパーオブジェクトを使用して、新しい`CameraCaptureSession`を作成します。
CreateCaptureSession(IList<Surface>, CameraCaptureSession+StateCallback, Handler)

CreateCaptureSession(SessionConfiguration)

サポートされているすべてのパラメーターを集計するSessionConfiguration ヘルパーオブジェクトを使用して、新しいCameraCaptureSessionを作成します。

[Android.Runtime.Register("createCaptureSession", "(Landroid/hardware/camera2/params/SessionConfiguration;)V", "GetCreateCaptureSession_Landroid_hardware_camera2_params_SessionConfiguration_Handler", ApiSince=28)]
public virtual void CreateCaptureSession(Android.Hardware.Camera2.Params.SessionConfiguration? config);

[<Android.Runtime.Register("createCaptureSession", "(Landroid/hardware/camera2/params/SessionConfiguration;)V", "GetCreateCaptureSession_Landroid_hardware_camera2_params_SessionConfiguration_Handler", ApiSince=28)>]
abstract member CreateCaptureSession : Android.Hardware.Camera2.Params.SessionConfiguration -> unit
override this.CreateCaptureSession : Android.Hardware.Camera2.Params.SessionConfiguration -> unit

パラメーター

config: SessionConfiguration

セッション構成 ( SessionConfigurationを参照)。

属性: RegisterAttribute

注釈

サポートされているすべてのパラメーターを集計するSessionConfiguration ヘルパーオブジェクトを使用して、新しいCameraCaptureSessionを作成します。

アクティブなキャプチャセッションは、キャプチャ要求ごとにカメラデバイスの潜在的な出力サーフェスのセットを決定します。特定の要求では、出力のすべてまたは一部のみを使用できます。 CameraCaptureSession が作成されたら、 CameraCaptureSession#capture capture、 CameraCaptureSession#captureBurst captureBurst、 CameraCaptureSession#setRepeatingRequest setRepeatingRequest、または CameraCaptureSession#setRepeatingBurst setRepeatingBurstを使用して要求を送信できます。

カメラ出力として含めるのに適したサーフェスは、さまざまなユースケースやターゲットに対して作成できます。

<ul>

<li>android.view.SurfaceView SurfaceViewに描画する: SurfaceView のSurfaceがandroid.view.SurfaceHolder.Callback#surfaceCreated createdされたら、android.view.SurfaceHolder#setFixedSizeのSurfaceのサイズを、StreamConfigurationMap#getOutputSizes(Class) getOutputSizes(SurfaceHolder.class)によって返されるサイズのいずれかに設定し、android.view.SurfaceHolder#getSurfaceを呼び出してSurfaceを取得します。サイズがアプリケーションによって設定されていない場合は、カメラデバイスによって、1080p 未満のサポートされている最も近いサイズに丸められます。</li>

<li>android.graphics.SurfaceTexture SurfaceTextureを介して OpenGL テクスチャを介してアクセスする場合: Surface#Surface(SurfaceTexture)を使用して SurfaceTexture からSurfaceを作成する前に、android.graphics.SurfaceTexture#setDefaultBufferSizeを持つ SurfaceTexture のサイズを、StreamConfigurationMap#getOutputSizes(Class) getOutputSizes(SurfaceTexture.class)によって返されるサイズのいずれかに設定します。サイズがアプリケーションによって設定されていない場合は、カメラデバイスによって、1080p 未満でサポートされる最小サイズに設定されます。</li>

<li>android.media.MediaCodecを使用した録音の場合: メディアコーデックを構成した後、android.media.MediaCodec#createInputSurfaceを呼び出して、StreamConfigurationMap#getOutputSizes(Class) getOutputSizes(MediaCodec.class)</li から返されるサイズのいずれかを使用します。>

<li>android.media.MediaRecorderを使用した録音の場合: StreamConfigurationMap#getOutputSizes(Class) getOutputSizes(MediaRecorder.class)によって返されるサイズのいずれかを使用するようにメディアレコーダーを構成した後、またはサポートされている android.media.CamcorderProfile CamcorderProfiles.< のいずれかを使用するようにメディアレコーダーを構成した後、android.media.MediaRecorder#getSurfaceを呼び出します。/li>

<li>アプリケーション内の RAW、圧縮されていない YUV、または圧縮された JPEG データにアクセスするには:StreamConfigurationMap#getOutputFormats()でサポートされている出力形式の 1 つを持つandroid.media.ImageReader オブジェクトを作成し、選択した出力形式をStreamConfigurationMap#getOutputSizes(int)に渡すことによって、そのサイズを対応するサポートされているサイズのいずれかに設定します。次に、android.media.ImageReader#getSurface()を使用してそこからandroid.view.Surfaceを取得します。 ImageReader サイズがサポートされているサイズに設定されていない場合は、カメラデバイスによってサポートされているサイズが 1080p 未満に丸められます。 </li>

</ul>

カメラデバイスは、この呼び出し時に各Surfaceのサイズと形式を照会するため、現時点では有効な設定に設定する必要があります。

カメラハードウェアの電源をオンまたは再構成する必要があるため、セッションの構成が完了するまでに数百ミリ秒かかる場合があります。構成が完了し、セッションが実際にデータをキャプチャする準備ができたら、指定された CameraCaptureSession.StateCallbackの CameraCaptureSession.StateCallback#onConfigured コールバックが呼び出されます。

このメソッドの呼び出し時に以前の CameraCaptureSession が既に存在する場合、前のセッションは新しいキャプチャ要求を受け入れることができなくなり、閉じられます。前のセッションで行われた進行中のキャプチャ要求は、閉じる前に完了します。 CameraCaptureSession.StateCallback#onConfigured 前のセッションに対して CameraCaptureSession.StateCallback#onClosed が呼び出される前に、新しいセッション用に呼び出すことができます。新しいセッションが CameraCaptureSession.StateCallback#onConfigured configuredされると、独自の要求のキャプチャを開始できます。切り替え時間を最小限に抑えるために、 CameraCaptureSession#abortCaptures 呼び出しを使用して、新しい要求が作成される前に、前のキャプチャセッションの残りの要求を破棄できます。新しいセッションが作成されると、古いセッションではキャプチャを中止できなくなることに注意してください。

より大きな解像度の出力またはより多くの出力を使用すると、デバイスからの出力速度が遅くなる可能性があります。

空または null リストを使用してセッションを構成すると、現在のセッションが閉じられます (存在する場合)。これを使用して、別の使用のために現在のセッションのターゲットサーフェスを解放できます。

この関数は、状態コールバックまたは有効な出力サーフェイスがない SessionConfiguration で呼び出された場合、 IllegalArgumentException をスローします。唯一の例外は、SurfaceView または SurfaceTexture の遅延出力です。詳細については、OutputConfiguration#OutputConfiguration(Size, Class) を参照してください。

<h3>Regular capture</h3>

1 つの出力ストリームが構成されている場合、 StreamConfigurationMap#getOutputSizes のどのサイズも使用できますが、複数の出力が一度に構成されている場合、特定のカメラデバイスでサイズ、形式、ターゲットのすべての組み合わせをサポートできない場合があります。次の表は、カメラデバイスの機能を考えると、ストリームとターゲットの組み合わせで保証される最大解像度を示しています。これらは、 android.hardware.camera2.params.SessionConfiguration#setInputConfiguration input configuration が設定されていないため、再処理がアクティブでない場合に有効です。

アプリケーションが、次の表に示す制限を超える一連のターゲットを使用してセッションを作成しようとすると、3 つの可能性のいずれかが発生する可能性があります。まず、セッションが正常に作成され、正常に動作する可能性があります。次に、セッションは正常に作成される可能性がありますが、 StreamConfigurationMap#getOutputMinFrameDurationで説明されているように、カメラデバイスはフレームレートの保証を満たしません。または、出力セットをまったく使用できない場合、セッションの作成は完全に失敗し、 CameraCaptureSession.StateCallback#onConfigureFailed が呼び出されます。

型列の場合、PRIVは、使用可能なサイズが直接アプリケーションに表示されない形式のStreamConfigurationMap#getOutputSizes(Class)を使用して検出されたターゲットを参照YUV、android.graphics.ImageFormat#YUV_420_888形式を使用するターゲット Surfaceを参照JPEG、android.graphics.ImageFormat#JPEG形式を参照し、RAWはandroid.graphics.ImageFormat#RAW_SENSOR形式を参照します。

最大サイズ列の場合、 PREVIEW は、デバイスの画面解像度または 1080p (1920x1080) のいずれか小さい方に一致する最適なサイズを指します。 RECORD は、 android.media.CamcorderProfileによって決定されるカメラデバイスのサポートされる最大記録解像度を指します。 MAXIMUMは、StreamConfigurationMap#getOutputSizesからのそのフォーマットまたはターゲットに対するカメラデバイスの最大出力解像度を指します。

これらのテーブルを使用するには、必要な出力の数と形式/ターゲットを決定し、それらのターゲットを含むテーブルの行を見つけます。サイズは、使用できるサイズの最大セットを示します。これらのターゲットの場合、 StreamConfigurationMap#getOutputSizes によって指定されたリストの一覧のサイズと小さい値をセッションの作成に正常に使用できることを保証します。たとえば、8 mp (MP) YUV_420_888出力を 2 MP PRIV 出力と共に使用できることを示す行がある場合、ターゲット [8 MP YUV, 2 MP PRIV] またはターゲット [2 MP YUV, 2 MP PRIV]でセッションを作成できますが、ターゲット [8 MP YUV, 4 MP PRIV]、ターゲット [4 MP YUV, 4 MP PRIV]、またはターゲット [8 MP PRIV, 2 MP YUV] を含むセッションは、このような組み合わせのテーブルリストの他の行を除き、動作することは保証されません。

<h5>LEGACY レベルの保証された構成</h5>

レガシデバイス (CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL==CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY LEGACY) では、少なくとも次のストリームの組み合わせがサポートされています。

<table><tr><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2</th><th colspan="2" id="rb">Target 3</th><th rowspan="2">Sample use case(s)</th></tr><tr><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th></tr><tr><td>PRIV</td><td id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td colspan="2" id="rb"></td><td>Simple プレビュー, GPU ビデオ処理, またはプレビューなしのビデオ録画.</td></tr><tr><td>JPEG</td><td id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td colspan="2" id="rb"></td><td>No-viewfinder still image capture.</td></tr><tr><td>YUV</td><td id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td colspan="2" id="rb"></td><td>In-application video/image processing.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>JPEG</td>< id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td>Standard still imaging.</td></tr><tr><td>YUV</td><td id="rb">PREVIEW</td><td>JPEG</td><t id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td>In-app processing plus still capture.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><><td id="rb">PREVIEW</tdtd colspan="2" id="rb"></td><td>Standard recording.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td>< td id="rb">PREVIEW</td><td colspan="2" id="rb"></td><td>Preview plus in-app processing.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><td>Still capture plus in-app processing.</td></tr></table><br>

<h5>LIMITED レベルの追加保証構成</h5>

制限付きレベル (CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL==CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED LIMITED) デバイスでは、 CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY LEGACY デバイスのストリームの組み合わせに加えて、少なくとも次のストリームの組み合わせがサポートされます。

<table><tr><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2</th ><th colspan="2" id="rb">Target 3</th><th rowspan="2">Sample use case(s)</th><></trtr><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><td id="rb">RECORD</td><td colspan="2" id="rb"></td><td> preview.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><ttd id="rb">RECORD</td><td colspan="2" id="rb"></td><td> preview.< による高解像度のアプリ内ビデオ処理/td></tr><tr><td>YUV</td><td id="rb">PREVIEW</td><td>YUV</td><td id ="rb">RECORD</td><td colspan="2" id="rb"></td><td>two-input in-app video processing.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><td id="rb">RECORD</td><td>JPEG</td><td id="rb">RECORD</td><td>ビデオスナップショットを使用した高解像度記録.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb ">RECORD</td><td>JPEG</td><td id="rb">RECORD</td><td>ビデオスナップショットを使用した高解像度のアプリ内処理</td></tr><tr><td>YUV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb ">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><td>two-input in-app processing with still capture.</td></tr></table><br>

<h5>FULL レベルの追加保証構成</h5>

FULL レベル (CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL==CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_FULL FULL) デバイスでは、 CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED LIMITED デバイスのストリームの組み合わせに加えて、少なくとも次のストリームの組み合わせがサポートされます。

<table><tr><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2<>><th colspan="2" id="rb"Target 3</th><th rowspan="2">Sample ユースケース< /th></tr><tr><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><td id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td>maximum-resolution GPU processing with preview.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><td id ="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td>Maximum-resolution with preview.</td></tr><tr><td>YUV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td>Maximum-resolution two-input in-app processing.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><td>最大サイズのビデオスナップショットを使用したビデオ録画</td></tr><tr><td>YUV</td><td id="rb">640x480</td><td>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">MAXIMUM</td><td>Standard ビデオ記録とアプリ内処理の最大解像度.</td></tr><tr><td>YUV</td><td id="rb">640x480</td><td>YUV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">MAXIMUM</td><td>Preview と 2 入力の最大解像度のアプリ内処理.</td></tr></table><br>

<h5>RAW-capability additional guaranteed configurations</h5>

RAW 機能 (CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIESCameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_RAW RAW を含む) デバイスでは、 CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_FULL FULL デバイスと CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED LIMITED デバイスの両方で、少なくとも次のストリームの組み合わせがサポートされます。

<table><tr><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2<>><th colspan="2" id="rb"Target 3</th><th rowspan="2">Sample ユースケース< /th></tr><tr><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th></tr><tr><td>RAW</td><td id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td colspan="2" id="rb"></td><td>No-preview DNG capture.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>RAW</td><t d id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td>Standard DNG capture.</td></tr><tr><td>YUV</td><td id="rb">PREVIEW</td><td>RAW</td><td id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td>In-app processing plus DNG capture.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><td id ="rb">PREVIEW</td><td>RAW</td><td id="rb">MAXIMUM</td><td>DNG capture.< を使用したビデオ記録/td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb ">PREVIEW</td><td>RAW</td><td id="rb">MAXIMUM</td><td>アプリ内処理と DNG capture.</td></tr><tr><td>YUV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">PREVIEW</td><td>RAW</td><td id="rb">MAXIMUM</td><td>Two-input in-app processing plus DNG capture.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><td>RAW</td><td id="rb">MAXIMUM</td><td> JPEG と DNG.< を同時に使用したStill キャプチャ/td></tr><tr><td>YUV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><td>RAW</td><td id="rb">MAXIMUM</td><td>同時 JPEG および DNG.< によるアプリの処理/td></tr></table><br>

<h5>BURST-capability additional guaranteed configurations</h5>

BURST 機能 (CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIESCameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_BURST_CAPTURE BURST_CAPTURE を含む) デバイスでは、 CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED LIMITED デバイスに加えて、少なくとも以下のストリームの組み合わせがサポートされます。 FULL レベルのデバイスはすべて BURST 機能をサポートしており、以下の一覧は FULL レベルデバイスのリストの厳密なサブセットであるため、この表は、BURST_CAPTURE機能をサポートする制限付きレベルのデバイスにのみ関連します。

<table><tr><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb"> 2</th><th rowspan="2">Sample ユースケース </th></tr><tr><th>Type </th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size </th></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><td id="rb">MAXIMUM</td><td> preview.< を使用したMaximum-resolution GPU 処理/td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">MAXIMUM</td><td>maximum-resolution in-app processing with preview.</td></tr><tr><td>YUV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">MAXIMUM</td><td>Maximum-resolution two-input in-app processing.</td></tr></table><br>

<h5>LEVEL-3 の追加保証構成</h5>

LEVEL-3 (CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL==CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_3 LEVEL_3) では、 CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_FULL FULL と RAW 機能の組み合わせに加えて、少なくとも次のストリームの組み合わせがサポートされます (CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES には CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_RAW RAWが含まれます)。

<table><tr><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2</th><><th colspan="2" id="rb">Target 3</thth colspan="2" id="rb">Target 4</th><th rowspan="2">サンプルユースケース </th></tr><tr><th>Type</th><th id="rb">Max size<><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">max size</th></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV<><td id="rb">640x480</td><td>YUV</td><td id="rb">MAXIMUM</td><td>RAW</td><td id="rb">MAXIMUM</td><td>In-app viewfinder 分析出力形式の動的選択.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><td id="rb">640x480</td><tdtd >JPEG</td><td id="rb">MAXIMUM</td><td>RAW</td><td id="rb">MAXIMUM</td><td>出力形式の動的選択によるアプリビューファインダー分析.</td></tr></table><br>

<h5>コンカレントストリーム保証構成</h5>

android.hardware.camera2.CameraManager#getConcurrentCameraIdsで説明されているように、他のデバイスと同時にストリーミングできるBACKWARD_COMPATIBLEデバイスには、次の保証されたストリームがあります (他のデバイスと同時にストリーミングする場合)

注: これらの同時ストリームに関して言及されているサイズは、サポートが保証される最大サイズです。特定の形式に対して StreamConfigurationMap#getOutputSizes して取得したサイズよりも小さいサイズもサポートされています。

<table><tr><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2 </th><th rowspan="2">Sample ユースケース </th></tr><tr><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th>< /tr><tr><td>YUV</td><td id="rb">s1440p</td><td colspan="2" id="rb"></td><td>In-app video / image processing.</td></tr><tr><td>PRIV</td><td id="rb">s1440p</td><td colspan="2" id="rb"></td><td>In-app viewfinder analysis.</td></tr><tr><td>JPEG</td><td id="rb">s1440p</td><td colspan="2" id="rb"></td><td>ビューファインダーの静止画像キャプチャがありません</td></tr><tr><td>YUV / PRIV</td><td id="rb">s720p</td><td>JPEG</td><td id="rb">s1440p</td><td> Standard still imaging.</td></tr><tr><td>YUV / PRIV</td><td id="rb">s720p</td><td>YUV / PRIV</td><td id="rb">s1440p</td><td>in-app video / processing with preview.</td></tr></table><br>

下位互換性のないデバイスでは、同時操作中にイメージ形式が DEPTH16 されたサイズ sVGA の必須の単一ストリームがサポートされます。

保証された同時実行ストリーム構成の場合:

sVGA とは、 StreamConfigurationMap#getOutputSizes または VGA 解像度 (640X480) のいずれか低い方からの、そのフォーマットに対するカメラデバイスの最大解像度を指します。

s720p は、 StreamConfigurationMap#getOutputSizes または 720p(1280X720) のいずれか低い方の形式のカメラデバイスの最大解像度を指します。

s1440p は、 StreamConfigurationMap#getOutputSizes または 1440p(1920X1440) のいずれか低い方の形式のカメラデバイスの最大解像度を指します。

をサポートするモノクロ機能 ( を含む) デバイスでは、デバイスのハードウェアレベルと機能に対して保証されるすべてのストリームの組み合わせで、ストリームをに置き換えることができます。

クライアントは、 android.hardware.camera2.params.MandatoryStreamCombination経由で上記の必須ストリームの組み合わせテーブルにアクセスできます。

HEIC 形式を出力できるデバイス (StreamConfigurationMap#getOutputFormatsandroid.graphics.ImageFormat#HEIC が含まれています) では、デバイスのハードウェアレベルと機能に対して保証されるすべてのストリームの組み合わせで、HEICを使用したJPEG ストリームの置換がサポートされます。 JPEG 出力と HEIC 出力の両方で createCaptureSession を呼び出すことはサポートされていません。

<h5>LEGACY レベルの追加の保証された組み合わせとマルチ解像度出力</h5>

特定のフォーマットに対してマルチ解像度出力が可能なデバイス ( android.hardware.camera2.params.MultiResolutionStreamConfigurationMap#getOutputInfo は空でないリストを返します) では、すべての必須ストリームの組み合わせに対して、その形式の MAXIMUM 解決ストリームに対して MultiResolutionImageReader を使用するサポートがサポートされます。たとえば、LIMITED カメラデバイスが、上記の LIMITED テーブルと Legacy テーブルのストリーム構成に加えて、 JPEG と PRIVATEの両方でマルチ解像度出力ストリームをサポートしている場合、カメラデバイスは次の保証されたストリームの組み合わせをサポートします ([最大サイズ] 列のMULTI_RES は、サポートされている可変の最大解像度に基づいて作成された MultiResolutionImageReader を参照します)。

<h5>LIMITED レベルの追加保証構成とマルチ解像度出力</h5>

<h5>ULTRA_HIGH_RESOLUTIONセンサーの追加保証組み合わせ</h5>

ULTRA_HIGH_RESOLUTION_SENSOR機能を持つデバイスには、クライアントが利用できるいくつかの追加の保証があります。

<table><tr><th colspan="3" id="rb">Target 1</th><th colspan="3" id="rb">Target 1 2</th><th colspan="3" id="rb">Target 3</th><th rowspan="2">Sample ユースケース </th></tr><tr><th>Type</th><th id="rb"> SC Map</th><th id="rb">Max size</th><th>Type</th><th id="rb"> SC Map</th><th id="rb">max size</th><th>Type</th><th id="rb"> SC Map</th><th id="rb ">Max size</th></tr><tr><td>YUV / JPEG / RAW</td><td id="rb">MAX_RES</td><>< td id="rb">MAX</td><td id="rb">PRIV / YUV</td><td id="rb">DEFAULT</td><td id="rb">PREVIEW</td><td colspan="3" id="rb"></tdtd>Ultra high res still image captureプレビュー</td></tr><tr><td>YUV / JPEG / RAW</td><td id="rb">MAX_RES</td><td id="rb">MAX</td><td id="rb">PRIV</td><td id="rb">DEFAULT</td><td id="rb">PREVIEW</td><td id="rb">PRIV / YUV</td><td id="rb">DEFAULT</td><td id="rb">RECORD</td><td>Ultra high res capture with preview + app based RECORD size analysis</td></tr><tr><td>YUV / JPEG / RAW</td><td id="rb">MAX_RES</td><td id="rb">MAX</td><td id="rb" >PRIV</td><td id="rb">DEFAULT</td><td id="rb">PREVIEW</td><td id="rb">JPEG / YUV / RAW</td><td id="rb">DEFAULT</td><td id="rb">MAX</td><td>プレビュー + 既定のセンサーピクセルモード分析ストリームを使用したUltra high res still image capture</td></tr></table><br>

ここで、SCマップは、 StreamConfigurationMapを参照し、ターゲットストリームサイズから選択する必要がある。 DEFAULT は既定のセンサーピクセルモード StreamConfigurationMap を指し、 MAX_RES は最大解像度 StreamConfigurationMapを指します。 MAX_RESストリームの場合、Max size列のMAXは、StreamConfigurationMap#getOutputSizesとStreamConfigurationMap#getHighResolutionOutputSizesからの最大サイズを参照します。注: 同じキャプチャ要求で、異なるセンサーピクセルモードに対応する StreamConfigurationMapのターゲットを混在させる必要はありません。

<h5>10 ビット出力の追加保証構成</h5>

デバイス CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_DYNAMIC_RANGE_TEN_BIT 対応の 10 ビット出力では、少なくとも次のストリームの組み合わせがサポートされます。

<table><tr><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2</th ><th colspan="2" id="rb">Target 3</th><th rowspan="2">Sample use case(s)</th><></trtr><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th></tr><tr><td>PRIV</td><td id="rb">MAXIMUM</td></td><td colspan="4" id="rb"></td><td>Simple プレビュー、GPU ビデオ処理、またはプレビューなしのビデオ録画。</td></tr><tr><td>YUV</td><td id="rb">MAXIMUM</td></td><td colspan="4" id="rb"></td><td>In-application video/image processing.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>JPEG</td>< td id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td>Standard still imaging.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td>maximum-resolution in-app processing with preview.</td></tr><tr><td>YUV</td><td id="rb">PREVIEW</td><td>YUV</td><td id ="rb">MAXIMUM</td><td colspan="2" id="rb"></td><td>Maximum-resolution two-input in-app processing.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><tt id="rb">RECORD</td><td colspan="2" id="rb"></td><td> preview.< を使用した高解像度ビデオ録画/td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><td id="rb ">RECORD</td><td>YUV</td><td id="rb">RECORD</td><td>アプリ内スナップショットを使用した高解像度の記録.</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><td id="rb">RECORD</td><td>JPEG</td><td id="rb">RECORD</td><td>ビデオスナップショットを使用した高解像度記録.</td></tr></table><br>

ここでは、PRIV は 8 ビットまたは 10 ビットの android.graphics.ImageFormat#PRIVATE ピクセル形式にすることができます。 YUV には、 android.graphics.ImageFormat#YUV_420_888 または android.graphics.ImageFormat#YCBCR_P010があります。最大サイズ列の場合、プレビューでは、デバイスの画面解像度または 1080p (1920x1080) のいずれか小さい方に一致する最適なサイズが参照されます。 RECORD は、 android.media.CamcorderProfileによって決まるカメラデバイスのサポートされる最大記録解像度を指します。 MAXIMUM は、 StreamConfigurationMap#getOutputSizes(int)からのそのフォーマットまたはターゲットに対するカメラデバイスの最大出力解像度を指します。 10 ビットプロファイルでピクセル形式の android.graphics.ImageFormat#YUV_420_888 を使用するようにカメラサーフェスを構成するなど、無効な組み合わせではキャプチャセッションの初期化エラーが発生することに注意してください。

android.graphics.ImageFormat#JPEG_R は、 android.hardware.camera2.params.StreamConfigurationMapによってアドバタイズされた場合にもサポートされる場合があります。 Jpeg/R カメラ出力クライアントを含むキャプチャセッションを初期化する場合は、次の項目を考慮する必要があります。10 ビットの必須ストリームの組み合わせテーブル。

<ul><li>圧縮された Jpeg/R 画像を生成するために、カメラデバイスによって内部的に 1 つのandroid.graphics.ImageFormat#YCBCR_P010出力が使用されます</li><li>同時に 10 ビットと 8 ビットのキャプチャ要求をサポートできるカメラデバイスでは、エンコードプロセスの高速化に役立つ追加のandroid.graphics.ImageFormat#JPEGも内部的に構成android.hardware.camera2.params.DynamicRangeProfiles#getProfileCaptureRequestConstraints確認できます</li></ul>

Jpeg/R カメラ出力では、通常、デバイスの最大解像度をサポートできます。クライアントは StreamConfigurationMap#getOutputSizes(int) を呼び出して、サポートされているサイズの完全な一覧を取得することもできます。上記の必須ストリームテーブルに収まらないストリームの組み合わせ内で Jpeg/R 出力を登録するカメラクライアントは、 #isSessionConfigurationSupported を呼び出して、この特定の構成がサポートされていることを確認できます。

<h5>STREAM_USE_CASE 機能の追加の保証された構成</h5>

STREAM_USE_CASE機能を備えたデバイス (CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIESCameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE を含む) では、以下の追加のストリームの組み合わせがサポートされます。

<table><tr><th colspan="3" id="rb">Target 1</th><th colspan="3" id="rb">Target 2</th><th colspan="3" id="rb">Target 3</th><th rowspan="2">Sample use case(s)<//th></tr><tr><th>Type</th><th id="rb">Max size</th><th>Usecase</th><<th>Type/th><th id="rb">Max size</th><th>Usecase</th><th>Type</th><th id="rb">Max size</th><th>Usecase</th></tr><tr><td>YUV / PRIV</td><td id="rb">PREVIEW</td><td id="rb">PREVIEW</td><td colspan="3" id="rb"></td><td colspan="3" id="rb"></td><td>Simple preview or in-app image processing</td></tr><tr><td>YUV / PRIV</td><td id="rb">RECORD</td><td id="rb">VIDEO_RECORD</td><td colspan="3" id="rb"></td><td colspan="3" id="rb"></td><td>Simple ビデオ録画またはアプリ内ビデオ処理</td/td/>< tr><tr><td>YUV / JPEG</td><td id="rb">MAXIMUM</td><td id="rb">STILL_CAPTURE</td><td colspan="3" id="rb"></td><td colspan="3" id="rb"></td><td>単純な JPEG または YUV の静止画像キャプチャ</td></tr><tr><td>YUV / PRIV</td><td id="rb">s1440p</td><td id="rb">PREVIEW_VIDEO_STILL</td><td colspan="3" id="rb"></td><td colspan="3" id="rb"></td><td>Multi-purpose stream for preview, video and still image capture</td></tr><tr><td>YUV / PRIV</td><td id="rb">s1440p</td><td id="rb">VIDEO_CALL</td><td colspan="3" id="rb"></td><td colspan="3" id="rb"></td><td>Simple ビデオ呼び出し</td></tr ><tr><td>PRIV</td><td id="rb">PREVIEW</td><td id="rb">PREVIEW</td><td>YUV / JPEG</td><td id="rb">MAXIMUM</td><td id="rb">STILL_CAPTURE</td><td colspan="3" id="rb"></td><td> JPEG または YUV 静止画像キャプチャ</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td>< td id="rb">PREVIEW</td><td>YUV / PRIV</td><td id="rb">RECORD</td><td id="rb">VIDEO_RECORD</td><td colspan="3" id="rb"></td><td>ビデオ録画またはアプリ内ビデオ処理</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td id="rb">PREVIEW</td><td>YUV<// td><td id="rb">PREVIEW</td><td id="rb">PREVIEW</td><td colspan="3" id="rb"></td><td>アプリケーション内画像処理を使用したPreview</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td id="rb">PREVIEW</td><td>YUV / PRIV</td><td id="rb">s1440p</td><><td id="rb">VIDEO_CALL</tdtd colspan="3" id="rb"></td><td>ビデオ通話付きPreview</td></tr><tr><td>YUV / PRIV</td><td id="rb">s1440p</td><td id="rb">PREVIEW_VIDEO_STILL</td><td>YUV / JPEG</td><td id="rb">MAXIMUM</td><td id="rb">STILL_CAPTURE</td><td colspan="3" id="jpeg または YUV を使用した rb"></td><td>MultI-purpose ストリーム</td></tr><tr><td>YUV</td><td id="rb">PREVIEW</td><td id="rb">STILL_CAPTURE</td><td>JPEG</td><td id="rb">MAXIMUM</td><td id="rb">STILL_CAPTURE</td><td colspan="3" id="rb"></td><td></td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td id="rb">PREVIEW</td><td>YUV / PRIV</td><td id="rb">RECORD</td><td id="rb">VIDEO_RECORD</td><td>JPEG<><td id="rb">RECORD</td><td id="rb">STILL_CAPTURE</td><td>Preview, ビデオレコードと JPEG ビデオスナップショット</td></tr><tr><td>PRIV</td><td id="rb">PREVIEW</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">PREVIEW</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><td id="rb">STILL_CAPTURE</td><td>Preview, アプリケーション内画像処理、JPEG 静止画像キャプチャ</td></tr></table><br>

<h5>STREAM_USE_CASE_CROPPED_RAW 機能の追加の保証された構成</h5>

CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASESにCameraMetadata#SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW ストリームのユースケースを含むデバイスでは、次の追加のストリームの組み合わせをサポートしています。

<h5>Preview 安定化保証ストリーム構成</h5>

CameraCharacteristics#CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODESにCameraMetadata#CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATIONが含まれるデバイスでは、次のストリームの組み合わせが保証されます。 CaptureRequest#CONTROL_VIDEO_STABILIZATION_MODEが CameraMetadata#CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION<table><tr><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2</th><th rowspan="2">Sample ユースケースの場合 (s)</th></tr><tr><th>Type</th><th id="rb">max size</th><th>Type</th><th id="rb">Max size</th></tr><tr><td>PRIV / YUV</td><td id="rb">s1440p</td><td colspan="2" id="rb"></td><td>スタビライズドプレビュー、GPU ビデオ処理、またはプレビューなし安定化ビデオ録画.</td></tr><tr><td>PRIV / YUV</td><td id="rb">s1440p</td><td>JPEG / YUV</td><td id="rb">MAXIMUM</td><td>Standard imaging with stabilized preview.</td></tr><tr><td>PRIV / YUV</td><td id="rb">PREVIEW</td><td>PRIV / YUV</td><td id="rb">s1440p</td><td>安定化プレビューと記録ストリームを使用した高解像度の記録.</td></tr></table><br>

最大サイズ列の場合、プレビューでは、デバイスの画面解像度または 1080p (1920x1080) のいずれか小さい方に一致する最適なサイズが参照されます。 RECORD は、 android.media.CamcorderProfileによって決まるカメラデバイスのサポートされる最大記録解像度を指します。 MAXIMUM は、 StreamConfigurationMap#getOutputSizes(int)からのそのフォーマットまたはターゲットに対するカメラデバイスの最大出力解像度を指します。

カメラデバイスの機能は大きく異なるため、特定のカメラデバイスでは、これらの保証外のサイズでターゲットの組み合わせをサポートできますが、これは、 #isSessionConfigurationSupported を呼び出すか、そのようなターゲットとのセッションを作成しようとすることによってのみテストできます。

176 x 144 (QCIF) 解像度の例外: カメラデバイスには通常、大きな解像度から小さい解像度へのダウンスケールの固定機能があり、高解像度のイメージセンサーを搭載したデバイスではこの制限のため、QCIF 解像度が完全にサポートされない場合があります。したがって、1920 x 1080 解像度 (幅または高さ) を超える他のストリームと共に QCIF 解像度ストリームを構成しようとすると、サポートされていない場合はキャプチャセッションの作成が失敗する可能性があります。

<h3>Reprocessing</h3>

カメラデバイスが YUV 再処理 (CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES_YUV_REPROCESSING) または PRIVATE 再処理 (CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES_PRIVATE_REPROCESSING) をサポートしている場合、アプリケーションは再処理可能なキャプチャセッションを作成して、セッションの android.hardware.camera2.params.SessionConfiguration#setInputConfiguration input configuration を設定することで、通常のキャプチャ要求に加えて再処理キャプチャ要求を送信することもできます。再処理キャプチャ要求は、セッションの入力Surfaceから次に使用可能なバッファーを受け取り、カメラデバイスの処理パイプラインを通じて再度送信して、要求のターゲット出力サーフェスのバッファーを生成します。再処理要求の新しいイメージデータはキャプチャされません。ただし、アプリケーションによって提供される入力バッファーは、同じセッション内の同じカメラデバイスによって以前にキャプチャされる必要があります (たとえば、ゼロShutter-Lag ユースケースの場合) または間接的 (複数の出力画像の組み合わせなど)。

アクティブな再処理可能なキャプチャセッションは、入力 Surface と、各キャプチャ要求のカメラデバイスの潜在的な出力サーフェスのセットを決定します。アプリケーションでは、 #createCaptureRequest createCaptureRequest を使用して、カメラデバイスから新しい画像をキャプチャする定期的なキャプチャ要求を作成し、 #createReprocessCaptureRequest createReprocessCaptureRequest を使用して入力 Surfaceからバッファーを処理する再処理キャプチャ要求を作成できます。セッション内の出力サーフェスの一部の組み合わせは、要求で同時に使用できない場合があります。要求で同時に使用できる出力サーフェスの保証された組み合わせは、 #createCaptureSession createCaptureSessionの表に一覧表示されます。 1 つのキャプチャ要求内のすべての出力サーフェスは、カメラデバイスによる新しいキャプチャから、または要求が再処理キャプチャ要求かどうかに応じてSurface入力から、同じソースから取得されます。

カメラデバイスでサポートされている入力形式とサイズは、 StreamConfigurationMap#getInputFormats と StreamConfigurationMap#getInputSizesを使用して照会できます。サポートされている各入力形式について、カメラデバイスは、 StreamConfigurationMap#getValidOutputFormatsForInput と StreamConfigurationMap#getOutputSizesを介して照会できる再処理用の一連の出力形式とサイズをサポートします。入力構成の有効な再処理出力ターゲットではない形式の出力サーフェスはセッションの一部にすることができますが、再処理要求のターゲットとして使用することはできません。

アプリケーションはandroid.graphics.ImageFormat#PRIVATEイメージに直接アクセスできないため、android.graphics.ImageFormat#PRIVATE形式のandroid.media.ImageReader#newInstanceによって作成された出力Surfaceは、入力の再処理に使用されることを意図したものと見なされるため、android.media.ImageReaderサイズは、android.graphics.ImageFormat#PRIVATE形式でサポートされている入力サイズのいずれかに一致する必要があります。そうしないと、再処理可能なキャプチャセッションの作成は失敗します。

API レベル 30 以降では、再処理可能なキャプチャセッションを再作成すると、キューに入っているが、まだ処理されていないバッファーがすべて入力サーフェイスからフラッシュされます。

カメラデバイスが YUV 再処理または PRIVATE 再処理をサポートしている場合は、次の表の構成で再処理可能なキャプチャセッションを作成できます。ただし、再処理可能なセッションの作成に使用されるすべての出力ターゲットを、 CaptureRequest で同時に使用できるわけではありません。再処理 CaptureRequestで 1 つの出力ターゲットのみをサポートするデバイスの場合、複数の出力ターゲットを含む再処理 CaptureRequest を送信すると、 CaptureFailureが発生します。再処理 CaptureRequestで複数の出力ターゲットをサポートするデバイスの場合、 CaptureRequest に同時に含めることができる保証された出力ターゲットは、 #createCaptureSession createCaptureSessionの下の表に一覧表示されます。たとえば、PRIVATE 再処理をサポートする FULL 機能 (CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL==CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_FULL FULL) デバイスでは、1 つの入力、(PRIV、 MAXIMUM)、および 3 つの出力 (PRIV、 MAXIMUM)、(PRIV、 PREVIEW)、および (YUV、 MAXIMUM) を使用して再処理可能なキャプチャセッションを作成できます。ただし、アプリケーションが、#createCaptureSession createCaptureSessionに記載されているテーブルに基づいて (PRIV、MAXIMUM) 出力と (YUV、MAXIMUM) 出力を使用して、通常のキャプチャまたは再処理キャプチャを送信できることは保証されません。つまり、次の表を使用して、再処理可能なキャプチャセッションを作成するための保証されたストリーム構成を決定し、 #createCaptureSession createCaptureSession のテーブルを使用して、通常の CaptureRequest または再処理で同時に送信できる保証された出力ターゲットを決定します。

10 ビット対応の CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES_DYNAMIC_RANGE_TEN_BIT デバイスで 10 ビット出力ターゲットを使用した再処理はサポートされていません。 10 ビットのダイナミックレンジプロファイルを使用するようにOutputConfiguration#setDynamicRangeProfile設定された 1 つ以上の出力構成を使用して、再キャプチャ可能なキャプチャセッションを初期化しようとすると、IllegalArgumentExceptionがトリガーandroid.hardware.camera2.params.DynamicRangeProfiles。

LIMITED レベル (CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL==CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED LIMITED) デバイスでは、前述の CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED LIMITED デバイスの通常のキャプチャに加えて、再処理可能なキャプチャセッションを作成するために、少なくとも次のストリームの組み合わせがサポートされています。

<table><tr><th colspan="11">LIMITED レベルの、再処理可能なキャプチャセッションを作成するための追加の保証された構成<br>(PRIV入力は、PRIVATE 再処理がサポートされている場合にのみ保証されます。 YUV入力は、YUV 再処理がサポートされている場合にのみ保証されます)</th></tr><tr><th colspan="2" id="rb">Input</th><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2</th><th colspan="2" id="rb">Target 3</th><th colspan="2" id="rb">Target 4</th><th rowspan="2">Sample ユースケース </th></tr><tr><th>Type</th><th id="rb">Max size</th><th>thtype</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size< /th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th></tr><tr><td>PRIV/YUV</td><tdid="rb">MAXIMUM</td><td>Same as input</td><td id="rb">MAXIMUM</td><td>JPEG</ttdd><td id="rb">MAXIMUM</td><td></td><td id="rb"></td><td></td><td id="rb"></td><td>No-viewfinder still image reprocessing.</td></tr><tr><td>PRIV/YUV</td><td id="rb">MAXIMUM</td><td> input</td><td id="rb">MAXIMUM</td><td>PRIV<></tdtd id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><td></td><td id="rb"></td><td>ZSL(Zero-Shutter-Lag) still imaging.</td></tr><tr><td>PRIV/YUV</td><td id="rb">MAXIMUM</td><td>入力として</td><td id="rb">MAXIMUM</td><td >YUV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><td></td><td id="rb"></td><td>ZSL still および in-app processing imaging.</td></tr><tr><td>PRIV/YUV</td><td id="rb">MAXIMUM</td><td>入力として</td><td id="rb">MAXIMUM</td><td>YUV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><まだ capture.< を使用した td>ZSL アプリ内処理/td></tr></table><br>

FULL レベル (CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL==CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_FULL FULL) デバイスでは、 CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED LIMITED デバイス用に加えて、再処理可能なキャプチャセッションを作成するために、少なくとも次のストリームの組み合わせがサポートされています。

<table><tr><th colspan="11">FULL レベルの、再処理可能なキャプチャセッションを作成するための追加の保証された構成<br>(PRIV入力は、PRIVATE 再処理がサポートされている場合にのみ保証されます。 YUV入力は、YUV 再処理がサポートされている場合にのみ保証されます)</th></tr><tr><th colspan="2" id="rb">Input</th><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2</th><th colspan="2" id="rb">Target 3</th><th colspan="2" id="rb">Target 4</th><th rowspan="2">Sample use case(s) </th/tr><><tr><th>Type</th><th id="rb">Max size</th><th>Type<>< th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Maxsize</th></tr><tr><td>YUV</td><td id="rb">MAXIMUM</td><td>YUV</td><td id="rb">MAXIMUM</td><td>PRIV</td><td id="rb"rb">PREVIEW</td><td></td><td id="rb"></td><td></td><td id="rb"></td><td>Maximum-resolution multi-frame image fusion in-app processing with regular preview.</td></tr><tr><td>YUV</td><td id="rb">MAXIMUM</td><td>YUV</td><td id="rb">MAXIMUM</td><td>YUV</td><tdd id="rb">PREVIEW</td><td></td><td id="rb"></td><td></td><td id="rb"></td><td>Maximum-resolution multi-frame image fusion2 入力のアプリ内 processing.</td></tr><tr><td>PRIV/YUV</td><td id="rb">MAXIMUM</td><td>入力として</td><td id="rb">MAXIMUM</td><td>PRIV< /td><td id="rb">PREVIEW</td><td>YUV</td><tdid="rb">RECORD</td><td></td><td id="rb"></td><td>通常の preview.< を使用した高解像度 ZSL アプリ内ビデオ処理/td></tr><tr><td>PRIV</td><td id="rb">MAXIMUM</td><td>PRIV</td><td id="rb">MAXIMUM</td><td>PRIV</td>< id="rb">PREVIEW</td><td>YUV</td><td id="rb">MAXIMUM</td><td></td><td id="rb"></td><td>Maximum-resolution通常の preview.< を使用した ZSL アプリ内処理/td></tr><tr><td>PRIV</td><td id="rb">MAXIMUM</td><td>PRIV</td><td id="rb">MAXIMUM</td><td>YUV</td>< id="rb">PREVIEW</td><td>YUV</td><td id="rb">MAXIMUM</td><td></td><td id="rb"></td><td>Maximum-resolution2 入力 ZSL アプリ内処理.</td></tr><tr><td>PRIV/YUV</td><tdid="rb">MAXIMUM</td><td>Same as input</td><td id="rb">MAXIMUM</td><tdd >PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><td>ZSL は引き続きキャプチャおよびアプリ内処理を行います。</td></tr></table><br>

RAW 機能 (CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIESCameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_RAW RAW を含む) デバイスでは、 CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_FULL FULL デバイスと CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED LIMITED デバイスの両方で再処理可能なキャプチャセッションを作成するために、少なくとも次のストリームの組み合わせがサポートされます

<table><tr><th colspan="11">RAW-capability additional guaranteed configurations for creating a reprocessable capture session<br>(PRIV input is guaranteeed if private reprocessing is supported. YUV 入力は、YUV 再処理がサポートされている場合にのみ保証されます)</th></tr><tr><th colspan="2" id="rb">Input</th><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2</th><th colspan="2" id="rb">Target 3</th><th colspan="2" id="rb">Target 4</th><th rowspan="2">Sample ユースケース </th></tr><tr><th>Type</th><th id="rb">Max size</th><th> Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size< /th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th></tr><tr><td>PRIV/YUV</td><tdid="rb">MAXIMUM</td><td>Same as input</td><td id="rb">MAXIMUM</td><td>YUV< /td><td id="rb">PREVIEW</td><td>RAW</td><td id="rb">MAXIMUM</td><td></td><td id="rb"></td><td>Mutually exclusive ZSLアプリ内処理と DNG capture.</td></tr><tr><td>PRIV/YUV</td><td id="rb">MAXIMUM</td><td>Same as input</td><td id="rb">MAXIMUM</td><ttd>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">PREVIEW</td><td>RAW</td><td id="rb">MAXIMUM</td><td> DNG capture.< を使用したアプリ内処理とプレビューを一時的に排他的な ZSL/td></tr><tr><td>PRIV/YUV</td><td id="rb">MAXIMUM</td><td> input</td><td id="rb">MAXIMUM</td><ttd>YUV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">PREVIEW</td><td>RAW</td><td id="rb">MAXIMUM</td><td>Mutually exclusive ZSL two-input in-app processing and DNG capture.</td></tr><tr><td>PRIV/YUV</td><td id="rb">MAXIMUM</td><td> input</td><td id="rb">MAXIMUM</td><td>PRIV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><td>RAW</td><td id="rb">MAXIMUM</td><td>DNG capture.< を使用した一時排他的 ZSL のキャプチャとプレビュー/td></tr><tr><td>PRIV/YUV</td><td id="rb">MAXIMUM</td><td> input</td><td id="rb">MAXIMUM</td><td>YUV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MAXIMUM</td><td>RAW</td><td id="rb">MAXIMUM</td><td>引き続きキャプチャと DNG capture.< を使用したアプリ内処理の一時排他的 ZSL/td></tr></table><br>

LEVEL-3 (CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL==CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_3 LEVEL_3) デバイスでは、再処理可能なキャプチャセッションを作成するためのストリームの組み合わせと、 CameraMetadata#INFO_SUPPORTED_HARDWARE_LEVEL_FULL FULL デバイス用のストリームの組み合わせが少なくともサポートされています。 2 番目の構成では、 MAXIMUMYUV 出力と JPEG 出力を同時に構成することができますが、その構成は通常のキャプチャセッションには一覧表示されないため、両方のターゲットへの同時出力は許可されないことに注意してください。

<table><tr><th colspan="13">LEVEL-3 の再処理可能なキャプチャセッションを作成するための追加の保証された構成<br>(PRIV 入力は、PRIVATE 再処理がサポートされている場合にのみ保証されます。 YUV 入力は常に保証されます。</th></tr><tr><th colspan="2" id="rb">Input</th><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2</th><th colspan="2" id="rb">Target 3</th ><th colspan="2" id="rb">Target 4</th><th colspan="2" id="rb">Target 5</th><th rowspan="2 2">Sample ユースケース </th></tr><tr><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size< /th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th></tr ><tr><td>YUV</td><td id="rb">MAXIMUM</td><td>YUV</td><td id="rb">MAXIMUM</td><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><td id="rb">640x480</td><td>RAW</td><td id="rb">MAXIMUM</td><td></td><td id="rb"></td><td>ZSL および RAW.< によるアプリ内ビューファインダー分析/td></tr><tr><td>PRIV/YUV</td><td id="rb">MAXIMUM</td><td>Same as input</td><td id="rb">MAXIMUM</td><td>PRIV</td><td id="rb">PREVIEW</td><td>PRIV</td><td id="rb">640x480</td><td>RAW</td><td id="rb">MAXIMUM</td><td>JPEG</td><td id="rb">MAXIMUM</td><td>ZSL、RAW、JPEG による出力の再処理を使用したアプリビューファインダー分析。</td></tr></table><br>

カメラデバイスが入力および多解像度YUV出力をサポートしている場合、または多解像度 YUVPRIVATE入力および多解像度PRIVATE出力をサポートしている場合、 LIMITED デバイスと FULL デバイスの追加の必須ストリームの組み合わせを以下に示します ([最大サイズ] 列のMULTI_RESは出力用のMultiResolutionImageReaderと入力用のマルチ解像度InputConfigurationを参照します):<table><tr><th colspan="11">複数解像度の入力とマルチ解像度の出力を使用して再処理可能なキャプチャセッションを作成するための制限付きレベルの追加の保証された構成<br>(PRIV入力は、PRIVATE 再処理がサポートされている場合にのみ保証されます。 YUV入力は、YUV 再処理がサポートされている場合にのみ保証されます)</th></tr><tr><th colspan="2" id="rb">Input</th ><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">Target 2</th><th colspan="2" id="rb">Target 3</th><th colspan="2" id="rb">Target 4</th><th rowspan="2">サンプルユースケース </th></tr><tr><th>Type</th><th id="rb">Max size </th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th></tr><tr><td>PRIV/YUV</td><td id="rb">MULTI_RES</td><td>Same as input</td><td id="rb">MULTI_RES</td>< td>JPEG</td><td id="rb">MULTI_RES</td><td></td><td id="rb"></td><td></td><td id="rb"></td><td>No-viewfinder image imagereprocessing.</td></tr><tr><td>PRIV/YUV</td><td id="rb">MULTI_RES</td><td> input</td><td id="rb">MULTI_RES</td><td>PRIV</td td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MULTI_RES</td><td></td><td id="rb"></td><td>ZSL(ゼロ-Shutter-Lag) まだイメージング.</td></tr><tr><td>PRIV/YUV</td><tdid="rb">MULTI_RES</td><td> input</td><td id="rb">MULTI_RES</td><td>YUV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MULTI_RES</td><td></td><td id="rb"></td><td>ZSL still および in-app processing imaging.</td></tr><tr><td>PRIV/YUV</td><td id="rb">MULTI_RES</td><td>入力として</td><td id="rb">MULTI_RES</td><td>YUV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MULTI_RES</td><まだ capture.< を使用した td>ZSL アプリ内処理/td></tr></table><br><table><tr><trth colspan="11">FULL レベルの追加の保証された構成で、マルチ解像度入力とマルチ解像度出力を使用して再処理可能なキャプチャセッションを作成します<br>(PRIV入力は、PRIVATE 再処理がサポートされている場合にのみ保証されます。 YUV入力は、YUV 再処理がサポートされている場合にのみ保証されます)</th></tr><tr><th colspan="2" id="rb">Input</th><th colspan="2" id="rb">Target 1</th><th colspan="2" id="rb">><Target 2</thth colspan="2" id="rb">Target 3</th><th colspan="2" id="rb">><Target 4</th><th rowspan="2">Sample use case(s)</th/tr><tr><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb">max size</th><th>Type</th><th id="rb">Max size</th><th>Type</th><th id="rb"th >max size</th></tr><tr><tr>PRIV</td><td id="rb">MULTI_RES</td><td>PRIV</td><td id="rb">MULTI_RES</td><td>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">MULTI_RES</td><td></td><td id="rb"></td><td>Maximum-resolution ZSL in-app processing with regular preview.</td></tr><tr><td>PRIV</td><td id="rb">MULTI_RES</td><td>PRIV</td><td id="rb">MULTI_RES</td><td>YUV</td>< id="rb">PREVIEW</td><td>YUV</td><td id="rb">MULTI_RES</td><td></td><td id="rb"></td><td>Maximum-resolution2 入力 ZSL アプリ内処理.</td></tr><tr><td>PRIV/YUV</td><td id="rb">MULTI_RES</td><td> input</td><td id="rb">MULTI_RES</td><td>PRIV</td><td id="rb">PREVIEW</td><td>YUV</td><td id="rb">PREVIEW</td><td>JPEG</td><td id="rb">MULTI_RES</td><td>ZSL は引き続きキャプチャおよびアプリ内処理を行います。</td></tr></table><br>

ULTRA_HIGH_RESOLUTION_SENSOR機能を備えたデバイスには、クライアントが利用できる追加の保証がいくつかあります。

<table><tr><th colspan="13">ULTRA_HIGH_RESOLUTION センサーの追加保証済み組み合わせ (YUV/PRIV 入力は、YUV/PRIVATE 再処理がサポートされている場合のみ保証されます)</th></tr><tr><th colspan="3" id="rb">Input</th></th >th colspan="3" id="rb">Target 1</th><th colspan="3" id="rb">Target 2</th><th colspan="3" id="rb">Target 3</th><th rowspan="2"サンプルユースケース </th></tr><tr><th>Type</th><th id="rb"> SC Map</th><>th id="rb"Max size</th><th>Type</th><th id="rb"> SC Map</th><th id="rb">Max size</th><th>Type</th><th id="rb"> SC Map</th><th id="rb">Max size</th><th>Type</th><th id="rb"> SC Map</th><th id="rb">Max size</th></tr><tr><td>RAW</td><td id="rb">MAX_RES</td><td id="rb">MAX</td><td>RAW</td><td id="rb">MAX_RES</td><ttd id="rb">MAX</td><td id="rb">PRIV / YUV</td><td id="rb">DEFAULT</td><td id="rb">PREVIEW</td><td colspan="3" id="rb"></td><td>RAW remosaic個別のプレビュー</td></tr><tr><td>RAW</td><td id="rb">MAX_RES</td><td id="rb">MAX</td><td>RAW</td><td id="rb ">MAX_RES</td><td id="rb">MAX</td><td id="rb">PRIV / YUV</td><td id="rb">DEFAULT</td><td id="rb">PREVIEW</td><td id="rb">JPEG / YUV</td><td id="rb">MAX_RES</td><td id="rb">MAX</td><td>Ultra high res RAW -> JPEG/YUV (プレビュー</td></tr><tr><td>YUV / PRIV</td><td id="rb">MAX_RES</td><td id="rb">MAX</td><td>YUV / PRIV</td><td id="rb">MAX_RES</td><td id="rb">MAX</td><td id="rb">YUV / PRIV</td><td id="rb">DEFAULT</td><td id="rb">PREVIEW</td><td id="rb">JPEG</td><td id="rb">MAX_RES</td><td id="rb">MAX</td><td> Ultra high res PRIV / YUV -> YUV/JPEG reprocessing with separate preview</td></tr></table><br>RAW 機能と LEVEL-3 ハードウェアレベルの追加の必須ストリームの組み合わせはありません。 /p< を >する

<h3>Constrained 高速記録</h3>

必要な高速 FPS 範囲がCameraCharacteristics#CONTROL_AE_AVAILABLE_TARGET_FPS_RANGESによってアドバタイズされている場合、アプリケーションは高速キャプチャにandroid.hardware.camera2.params.SessionConfiguration#SESSION_REGULAR normal capture sessionを使用できます。その場合、通常のキャプチャセッションに関連付けられているすべての API セマンティクスが適用されます。

android.hardware.camera2.params.SessionConfiguration#SESSION_HIGH_SPEED high-speed capture sessionは、カメラデバイスが高速ビデオ機能 (つまり、CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_CONSTRAINED_HIGH_SPEED_VIDEOを含むCameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES) をサポートしている場合に、高速ビデオ記録 (> = 120fps) に使用できます。制約付き高速キャプチャセッションには、通常のキャプチャセッションと比較して特別な制限があります。

<ul>

<li>通常のキャプチャに対して上記で指定した出力ターゲットSurface要件に加えて、高速キャプチャセッションでは最大 2 つの出力サーフェスのみがサポートされますが、アプリケーションでは 1 つのSurfaceのみを構成できます (プレビューのみなど)。すべてのサーフェスは、ビデオエンコーダーサーフェス (android.media.MediaRecorder#getSurfaceまたはandroid.media.MediaCodec#createInputSurfaceで取得) またはプレビューサーフェス (android.view.SurfaceViewから取得、android.view.Surface#Surface(android.graphics.SurfaceTexture)経由でandroid.graphics.SurfaceTexture) である必要があります。 Surfaceサイズは、StreamConfigurationMap#getHighSpeedVideoSizesによって報告されるサイズのいずれかである必要があります。複数のサーフェスを構成する場合、そのサイズは同じである必要があります。</li>

<li>アクティブな高速キャプチャセッションでは、 CameraConstrainedHighSpeedCaptureSession#createHighSpeedRequestListを介して作成された要求リストのみを受け入れ、要求リストは CameraCaptureSession#captureBurst captureBurst または CameraCaptureSession#setRepeatingBurst setRepeatingBurst.< を介してのみこのセッションに送信できます。/li>

<li>このセッションに要求される FPS 範囲は、 StreamConfigurationMap#getHighSpeedVideoFpsRangesForから選択する必要があります。アプリケーションは引き続き CaptureRequest#CONTROL_AE_TARGET_FPS_RANGE を使用して目的の FPS 範囲を制御できます。 android.util.Range#getUpper() maximum FPSが異なる FPS 範囲に切り替えると、一部のカメラデバイスの再構成がトリガーされ、待機時間が長くなる可能性があります。アプリケーションでは、高速ストリーミング中にターゲット FPS の変更が可能な限り最大で不要にならないようにすることをお勧めします</li>

<li>このセッションに送信された要求リストでは、カメラデバイスは、 CaptureRequest#CONTROL_MODE control mode、自動露出 (AE)、自動ホワイトバランス (AWB)、オートフォーカス (AF) をそれぞれ CameraMetadata#CONTROL_MODE_AUTO、 CameraMetadata#CONTROL_AE_MODE_ON、 CameraMetadata#CONTROL_AWB_MODE_AUTO 、および CameraMetadata#CONTROL_AF_MODE_CONTINUOUS_VIDEOにオーバーライドします。すべての後処理ブロックモードコントロールは、FAST にオーバーライドされます。そのため、キャプチャと後処理のパラメーターを手動で制御できません。その他に、コントロールのサブセットのみが機能します。詳細については、 CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_CONSTRAINED_HIGH_SPEED_VIDEO を参照してください。</li>

</ul>

Javaドキュメント。

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

適用対象

CreateCaptureSession(IList<Surface>, CameraCaptureSession+StateCallback, Handler)

[Android.Runtime.Register("createCaptureSession", "(Ljava/util/List;Landroid/hardware/camera2/CameraCaptureSession$StateCallback;Landroid/os/Handler;)V", "GetCreateCaptureSession_Ljava_util_List_Landroid_hardware_camera2_CameraCaptureSession_StateCallback_Landroid_os_Handler_Handler")]
public abstract void CreateCaptureSession(System.Collections.Generic.IList<Android.Views.Surface> outputs, Android.Hardware.Camera2.CameraCaptureSession.StateCallback callback, Android.OS.Handler? handler);

[<Android.Runtime.Register("createCaptureSession", "(Ljava/util/List;Landroid/hardware/camera2/CameraCaptureSession$StateCallback;Landroid/os/Handler;)V", "GetCreateCaptureSession_Ljava_util_List_Landroid_hardware_camera2_CameraCaptureSession_StateCallback_Landroid_os_Handler_Handler")>]
abstract member CreateCaptureSession : System.Collections.Generic.IList<Android.Views.Surface> * Android.Hardware.Camera2.CameraCaptureSession.StateCallback * Android.OS.Handler -> unit

パラメーター

outputs: IList<Surface>

callback: CameraCaptureSession.StateCallback

handler: Handler

属性: RegisterAttribute

注釈

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

適用対象