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#createReprocessableCaptureSessionを使用CameraDevice#createCaptureSessionしてカメラ デバイスを新しいセッションに切り替える最も速い方法です。 新しいセッションを作成する前に呼び出す必要があります。 保留中のすべての要求が完了するか、破棄されると、 StateCallback#onReady セッションが閉じていない場合はコールバックが呼び出されます。 それ以外の StateCallback#onClosed 場合、カメラ デバイスによって新しいセッションが作成されると、コールバックが発生します。

カメラ デバイスが空になると、新しい出力バッファーが生成される前に、最初の新しい要求がカメラ パイプライン全体を通過する必要があるため、カメラ デバイスからのデータストリームに少なくとも一時停止が発生します。

つまり、 を使用して abortCaptures() 保留中の要求を削除することはお勧めしません。出力構成をすばやく切り替えたり、進行中の長い要求 (複数秒のキャプチャなど) を取り消したりする場合に最適です。

の android.hardware.camera2.CameraCaptureSession.abortCaptures()Java ドキュメント。

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

こちらもご覧ください

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