CameraCaptureSession.FinalizeOutputConfigurations メソッド

[Android.Runtime.Register("finalizeOutputConfigurations", "(Ljava/util/List;)V", "GetFinalizeOutputConfigurations_Ljava_util_List_Handler", ApiSince=26)]
public abstract void FinalizeOutputConfigurations(System.Collections.Generic.IList<Android.Hardware.Camera2.Params.OutputConfiguration>? outputConfigs);

[<Android.Runtime.Register("finalizeOutputConfigurations", "(Ljava/util/List;)V", "GetFinalizeOutputConfigurations_Ljava_util_List_Handler", ApiSince=26)>]
abstract member FinalizeOutputConfigurations : System.Collections.Generic.IList<Android.Hardware.Camera2.Params.OutputConfiguration> -> unit

パラメーター

属性

RegisterAttribute

注釈

遅延または追加のサーフェスが含まれるようになった出力構成を最終処理します。

プレビューやその他の出力構成を構成する必要があるカメラのユース ケースでは、プレビュー Surfaceの準備が整うのに時間がかかる場合があります。 たとえば、プレビュー Surfaceが android.view.SurfaceView から取得された場合、SurfaceView は UI レイアウトが完了した後にのみ準備が整い、カメラの起動が遅れる可能性があります。

カメラの起動時間を短縮するために、アプリケーションは最終的なプレビュー サイズ (OutputConfiguration#OutputConfiguration(Size,Class) a deferred OutputConfiguration 経由) でCameraCaptureSessionを構成し、Surfaceの準備ができるまでプレビュー出力構成を延期できます。 この遅延出力とその他の通常の出力を使用して CameraCaptureSession が正常に作成された後、遅延出力サーフェスが含まれていない限り、アプリケーションは要求の送信を開始できます。 遅延Surfaceの準備ができたら、アプリケーションは、OutputConfiguration#addSurface メソッドを使用して遅延出力構成にSurfaceを追加し、この出力ターゲットでキャプチャ要求を送信する前に、このメソッドを使用して遅延出力構成を更新できます。

この関数は、複数のサーフェスが同じ OutputConfiguration を共有し、 CameraCaptureSession の作成後にいずれかのサーフェスが使用可能になった場合にも呼び出すことができます。 その場合、アプリケーションは、最初に使用可能なSurfaceを使用して OutputConfiguration を作成し、OutputConfiguration#enableSurfaceSharing経由でさらにsurface共有を有効にしてから、CameraCaptureSession を作成する必要があります。 CameraCaptureSession が作成され、追加のSurfaceが使用可能になったら、アプリケーションは、このメソッドで構成を終了する前にOutputConfiguration#addSurfaceを呼び出す必要があります。

指定された OutputConfigurations がセッションの作成から変更されていない場合、この関数呼び出しは無効になります。 この関数は、特定の出力構成に対して 1 回だけ呼び出す必要があります。

この OutputConfiguration OutputConfigurations の一覧に含まれる出力サーフェスは、この呼び出しが戻るとすぐに CaptureRequest ターゲットとして使用できます。

この方法は、 CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY LEGACY レベルのデバイスではサポートされていません。

Javaドキュメント。

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