Lenguaje

CameraCaptureSession.AbortCaptures Método

Definición

Descarte todas las capturas actualmente pendientes y en curso lo más rápido posible.

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

Excepciones

si el dispositivo de cámara ya no está conectado o ha encontrado un error irrecuperable

si esta sesión ya no está activa, ya sea porque la sesión se cerró explícitamente, se ha creado una nueva sesión o se ha cerrado el dispositivo de cámara.

Comentarios

Descarte todas las capturas actualmente pendientes y en curso lo más rápido posible.

El dispositivo de cámara descartará todo su trabajo actual lo más rápido posible. Algunas capturas en curso pueden completarse correctamente y llamar a CaptureCallback#onCaptureCompleted, mientras que otras desencadenarán sus CaptureCallback#onCaptureFailed devoluciones de llamada. Si se establece una solicitud de repetición o una ráfaga de repetición, se borrará.

Este método es la forma más rápida de cambiar el dispositivo de cámara a una nueva sesión con CameraDevice#createCaptureSession o CameraDevice#createReprocessableCaptureSession, a costa de descartar el trabajo en curso. Se debe llamar antes de crear la nueva sesión. Una vez completadas o desechadas todas las solicitudes pendientes, se llamará a la StateCallback#onReady devolución de llamada, si no se ha cerrado la sesión. De lo contrario, la StateCallback#onClosed devolución de llamada se activará cuando el dispositivo de cámara cree una nueva sesión.

La cancelación introducirá al menos una breve pausa en el flujo de datos del dispositivo de cámara, ya que una vez que se vacía el dispositivo de cámara, la primera solicitud nueva tiene que hacerlo a través de toda la canalización de la cámara antes de que se produzcan nuevos búferes de salida.

Esto significa que no se recomienda usar abortCaptures() para quitar simplemente las solicitudes pendientes; se usa mejor para cambiar rápidamente las configuraciones de salida o para cancelar solicitudes largas en curso (como una captura de varios segundos).

Java documentación para android.hardware.camera2.CameraCaptureSession.abortCaptures().

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a

Consulte también

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