Partager via


CameraCaptureSession.Close Méthode

Définition

Fermez cette session de capture de manière asynchrone.

[Android.Runtime.Register("close", "()V", "GetCloseHandler")]
public abstract void Close ();
[<Android.Runtime.Register("close", "()V", "GetCloseHandler")>]
abstract member Close : unit -> unit

Implémente

Attributs

Remarques

Fermez cette session de capture de manière asynchrone.

La fermeture d’une session libère les Surfaces de sortie cibles de la session pour une réutilisation avec une nouvelle session ou vers d’autres API qui peuvent dessiner sur Surfaces.

Notez que pour les scénarios d’utilisation courants tels que la création d’une session ou la fermeture de l’appareil photo, il est plus rapide d’appeler directement les API respectives (voir ci-dessous pour plus d’informations) sans appeler cette méthode. Cette API est utile uniquement lorsque l’application souhaite annuler la configuration de l’appareil photo, mais que l’appareil reste ouvert pour une utilisation ultérieure.

La création d’une nouvelle session de capture avec CameraDevice#createCaptureSession ferme automatiquement toute session de capture existante et appelle le rappel de l’écouteur de StateCallback#onClosed session plus ancien. L’utilisation CameraDevice#createCaptureSession directe sans fermeture est l’approche recommandée pour passer rapidement à une nouvelle session, car les sorties cibles inchangées peuvent être réutilisées plus efficacement.

La fermeture directe de l’appareil CameraDevice#close sans appeler cette API est également recommandée pour fermer rapidement l’appareil photo.

Une fois qu’une session est fermée, toutes les méthodes dessus lèvent une exception IllegalStateException et toutes les demandes ou rafales répétées sont arrêtées (comme si #stopRepeating() elle était appelée). Toutefois, toutes les demandes de capture en cours soumises à la session seront effectuées normalement ; une fois toutes les captures terminées et que la session a été détruite, StateCallback#onClosed sera appelée.

La fermeture d’une session est idempotente ; la fermeture plusieurs fois n’a aucun effet.

Documentation Java pour android.hardware.camera2.CameraCaptureSession.close().

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

S’applique à