CameraCaptureSession.Close Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.