語言

CameraCaptureSession.AbortCaptures 方法

定義

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

盡快丟棄所有目前待捕獲或進行中的捕獲。

[Android.Runtime.Register("abortCaptures", "()V", "GetAbortCapturesHandler")]
public abstract void AbortCaptures();
[<Android.Runtime.Register("abortCaptures", "()V", "GetAbortCapturesHandler")>]
abstract member AbortCaptures : unit -> unit
屬性
RegisterAttribute

例外狀況

CameraAccessException

如果相機裝置已斷線或遇到致命錯誤

IllegalStateException

如果該會話不再活躍，無論是因為會話被明確關閉、新會話已建立，或是攝影機裝置已被關閉。

備註

盡快丟棄所有目前待捕獲或進行中的捕獲。

相機裝置會盡快丟棄所有目前的工作。 部分飛行中擷取可能成功完成並呼叫 CaptureCallback#onCaptureCompleted，而另一些則會觸發回 CaptureCallback#onCaptureFailed 撥。 如果設定了重複請求或重複突發，該請求會被清除。

此方法是將攝影機裝置切換到新CameraDevice#createCaptureSessionCameraDevice#createReprocessableCaptureSession會話中，且代價是捨棄進行中的工作。 必須在建立新會話前就呼叫它。 當所有待處理請求完成或被丟棄後， StateCallback#onReady 若會話尚未關閉，回調將被呼叫。 否則， StateCallback#onClosed 當攝影機裝置建立新工作階段時，回調會被觸發。

取消會讓攝影機資料流至少短暫暫停，因為一旦攝影機裝置清空，第一個新請求必須通過整個攝影機管線，才能產生新的輸出緩衝區。

這表示不建議僅用來 abortCaptures() 移除待處理的請求;它最適合用於快速切換輸出配置，或取消長時間進行中的請求（例如數秒的擷取）。

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

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

適用於

另請參閱

  • <xref:Android.Hardware.Camera2.CameraCaptureSession.SetRepeatingRequest(Android.Hardware.Camera2.CaptureRequest%2c+.CaptureCallback%2c+.CaptureCallback)>