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 佈局完成後才會準備好，可能會延遲攝影機啟動。

為了加快相機啟動時間，應用程式可以設定CameraCaptureSession最終的預覽大小（透過 OutputConfiguration#OutputConfiguration(Size,Class) a deferred OutputConfiguration），並將預覽輸出設定延後，直到 Surface 準備好再進行。 在成功建立此延遲輸出及其他正常輸出後 CameraCaptureSession ，應用程式可開始提交請求，只要不包含延遲輸出表面。 一旦延遲 Surface 準備好，應用程式即可將OutputConfiguration#addSurface該 Surface 加入延遲輸出配置，並透過此方法更新延遲輸出配置，然後才能提交該輸出目標的擷取請求。

當多個曲面共用相同的 OutputConfiguration，且其中一個曲面在建立後 CameraCaptureSession 變得可用時，也可呼叫此函式。 在這種情況下，應用程式必須先用可用的 Surface 建立 OutputConfiguration，然後透過 OutputConfiguration#enableSurfaceSharing開啟進一步的 surface 共享，然後才建立 CameraCaptureSession。 在建立 CameraCaptureSession 後，當額外的 Surface 可用時，應用程式必須先呼叫OutputConfiguration#addSurface，才能用此方法完成設定。

如果所提供的 OutputConfigurations 在建立會話時未改變，則此函式呼叫不會產生影響。 此函式只需針對特定輸出配置呼叫一次。

此清單 OutputConfiguration OutputConfigurations 中包含的輸出 Surfaces，一旦呼叫返回即可作為 CaptureRequest 目標使用。

此方法不被 CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY LEGACY-level 裝置支援。

Java 文件 android.hardware.camera2.CameraCaptureSession.finalizeOutputConfigurations(java.util.List<android.hardware.camera2.params.OutputConfiguration>)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。