Langue

CameraCaptureSession.AbortCaptures Méthode

Définition

Ignorez toutes les captures actuellement en attente et en cours aussi rapidement que possible.

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

Exceptions

si l’appareil photo n’est plus connecté ou a rencontré une erreur irrécupérable

si cette session n’est plus active, soit parce que la session a été explicitement fermée, qu’une nouvelle session a été créée ou que l’appareil photo a été fermé.

Remarques

Ignorez toutes les captures actuellement en attente et en cours aussi rapidement que possible.

L’appareil photo ignore tout son travail actuel aussi rapidement que possible. Certaines captures en vol peuvent se terminer correctement et appeler CaptureCallback#onCaptureCompleted, tandis que d’autres déclenchent leurs CaptureCallback#onCaptureFailed rappels. Si une demande répétée ou une rafale répétée est définie, elle est effacée.

Cette méthode est le moyen le plus rapide de basculer l’appareil photo vers une nouvelle session avec CameraDevice#createCaptureSession ou CameraDevice#createReprocessableCaptureSession, au coût de l’abandon du travail en cours. Elle doit être appelée avant la création de la nouvelle session. Une fois que toutes les demandes en attente sont terminées ou levées, le StateCallback#onReady rappel est appelé si la session n’a pas été fermée. Sinon, le StateCallback#onClosed rappel est déclenché lorsqu’une nouvelle session est créée par l’appareil photo.

L’annulation introduit au moins une brève pause dans le flux de données de l’appareil photo, car une fois que l’appareil photo est vidé, la première nouvelle demande doit le faire via l’intégralité du pipeline de caméra avant la production de nouvelles mémoires tampons de sortie.

Cela signifie que l’utilisation abortCaptures() pour supprimer simplement les demandes en attente n’est pas recommandée ; il est préférable de basculer rapidement les configurations de sortie ou d’annuler des demandes longues en cours (par exemple, une capture à plusieurs secondes).

Java documentation pour android.hardware.camera2.CameraCaptureSession.abortCaptures().

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à

Voir aussi

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