CameraCaptureSession.Close 方法

[Android.Runtime.Register("close", "()V", "GetCloseHandler")]
public abstract void Close();

[<Android.Runtime.Register("close", "()V", "GetCloseHandler")>]
abstract member Close : unit -> unit

實作

屬性

RegisterAttribute

備註

非同步關閉此擷取會話。

關閉會話會釋放該會話的目標輸出 Surface，供新 session 或其他能繪製 Surface 的 API 重用。

請注意，對於常見的使用情境，例如建立新工作階段或關閉攝影機裝置，直接呼叫相應的 API（詳見下文），而不必呼叫這個方法。 這個 API 只有在應用程式想取消設定攝影機但保留裝置以備後續使用時才有用。

建立新的擷取會話 CameraDevice#createCaptureSession ，會自動關閉所有現有的擷取會話，並呼叫舊的會話監聽者的 StateCallback#onClosed 回撥。 直接使用 CameraDevice#createCaptureSession 且不關閉是快速切換新工作階段的推薦方法，因為未改變的目標輸出能更有效率地重複使用。

也建議直接關閉裝置 CameraDevice#close ，不呼叫此 API，以快速關閉相機。

一旦一個會話關閉，所有方法都會拋出 IllegalStateException，任何重複的請求或突發都會被停止（就像 #stopRepeating() 被呼叫一樣）。 然而，任何提交給會話的進行中的擷取請求將照常完成;當所有捕獲完成且會議結束後， StateCallback#onClosed 將會被召集。

結束會話是冪次元;關閉超過一次則沒有影響。

Java 文件 android.hardware.camera2.CameraCaptureSession.close()。

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