CameraCaptureSession.AbortCaptures Método

Definição

Namespace:: Android.Hardware.Camera2

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Descarte todas as capturas atualmente pendentes e em andamento o mais rápido possível.

[Android.Runtime.Register("abortCaptures", "()V", "GetAbortCapturesHandler")]
public abstract void AbortCaptures();

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

Atributos: RegisterAttribute

Exceções

CameraAccessException

se o dispositivo de câmera não estiver mais conectado ou tiver encontrado um erro fatal

IllegalStateException

se essa sessão não estiver mais ativa, porque a sessão foi fechada explicitamente, uma nova sessão foi criada ou o dispositivo de câmera foi fechado.

Comentários

Descarte todas as capturas atualmente pendentes e em andamento o mais rápido possível.

O dispositivo de câmera descartará todo o trabalho atual o mais rápido possível. Algumas capturas em voo podem ser concluídas com êxito e chamadas CaptureCallback#onCaptureCompleted, enquanto outras dispararão seus CaptureCallback#onCaptureFailed retornos de chamada. Se uma solicitação repetida ou uma intermitência repetida for definida, ela será desmarcada.

Esse método é a maneira mais rápida de alternar o dispositivo de câmera para uma nova sessão com CameraDevice#createCaptureSession ou CameraDevice#createReprocessableCaptureSession, ao custo de descartar o trabalho em andamento. Ele deve ser chamado antes da criação da nova sessão. Depois que todas as solicitações pendentes forem concluídas ou descartadas, o StateCallback#onReady retorno de chamada será chamado, se a sessão não tiver sido fechada. Caso contrário, o StateCallback#onClosed retorno de chamada será acionado quando uma nova sessão for criada pelo dispositivo de câmera.

O cancelamento introduzirá pelo menos uma breve pausa no fluxo de dados do dispositivo de câmera, já que uma vez que o dispositivo de câmera é esvaziado, a primeira nova solicitação precisa passar por todo o pipeline da câmera antes que novos buffers de saída sejam produzidos.

Isso significa que o uso abortCaptures() para simplesmente remover solicitações pendentes não é recomendado; ele é melhor usado para alternar rapidamente as configurações de saída ou para cancelar solicitações longas em andamento (como uma captura de vários segundos).

Java documentação para android.hardware.camera2.CameraCaptureSession.abortCaptures().

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a

Confira também

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