語言

CameraDevice.CreateExtensionSession(ExtensionSessionConfiguration) 方法

定義

命名空間:
Android.Hardware.Camera2
組件:
Mono.Android.dll

初始化特定裝置的擴充攝影機擷取會話。

[Android.Runtime.Register("createExtensionSession", "(Landroid/hardware/camera2/params/ExtensionSessionConfiguration;)V", "GetCreateExtensionSession_Landroid_hardware_camera2_params_ExtensionSessionConfiguration_Handler", ApiSince=31)]
public virtual void CreateExtensionSession(Android.Hardware.Camera2.Params.ExtensionSessionConfiguration extensionConfiguration);
[<Android.Runtime.Register("createExtensionSession", "(Landroid/hardware/camera2/params/ExtensionSessionConfiguration;)V", "GetCreateExtensionSession_Landroid_hardware_camera2_params_ExtensionSessionConfiguration_Handler", ApiSince=31)>]
abstract member CreateExtensionSession : Android.Hardware.Camera2.Params.ExtensionSessionConfiguration -> unit
override this.CreateExtensionSession : Android.Hardware.Camera2.Params.ExtensionSessionConfiguration -> unit

參數

extensionConfiguration
ExtensionSessionConfiguration

擴充配置

屬性
RegisterAttribute

備註

初始化特定裝置的擴充攝影機擷取會話。

擴充工作階段可用來啟用裝置專屬的操作模式，如 CameraExtensionCharacteristics#EXTENSION_NIGHT 或 CameraExtensionCharacteristics#EXTENSION_HDR。 這些模式彈性不如完整相機 API，但能使用更先進的處理演算法，捕捉多幀連發以產生單一輸出影像。 若要查詢此裝置上的可用分機，請呼叫 CameraExtensionCharacteristics#getSupportedExtensions()。

此方法同時會觸發內部處理流程的設置，用於擴充預覽及多幀靜態捕捉。

若呼叫此方法時已有先前的 CameraCaptureSession，該前一個 session 將無法再接受新的擷取請求並關閉。 上一次會話中進行中的擷取請求會在結束前完成。

CameraExtensionSession 會一直處於啟用狀態，直到用戶端呼叫 CameraExtensionSession.close（） 或建立新的相機擷取會話為止。 在這兩種情況下，所有內部資源都會被釋放，持續重複的請求會停止，並清除任何待處理的多幀擷取請求。

請注意，CameraExtensionSession 目前最多支援 2 個多影格擷取表面格式：ImageFormat.JPEG 將被所有擴充支援，ImageFormat.YUV_420_888可能支援也可能不支援。 用戶端必須使用 CameraExtensionCharacteristics#getExtensionSupportedSizes(int, int)。 對於重複請求，CameraExtensionSession 僅 android.graphics.SurfaceTexture 支援輸出。 用戶端可利用 CameraExtensionCharacteristics#getExtensionSupportedSizes(int, Class) getExtensionSupportedSizes(..., Class)查詢重複請求輸出的支援解析。

至少初始化時預期有一個有效的輸出面用於重複，或一個有效的高品質單一請求輸出，這些請求記錄在擴充組態參數的輸出參數中。 在最大值下，初始化可接受兩個有效的輸出表面，一個用於重複，另一個用於單一請求。 若額外被傳入 ExtensionSessionConfiguration 的非受支撐表面，會導致拋出 。IllegalArgumentException

Java 文件 android.hardware.camera2.CameraDevice.createExtensionSession(android.hardware.camera2.params.ExtensionSessionConfiguration)。

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

適用於