ImageReader.AcquireNextImage Methode

Definition

Rufen Sie das nächste Bild aus der ImageReader-Warteschlange ab.

[Android.Runtime.Register("acquireNextImage", "()Landroid/media/Image;", "GetAcquireNextImageHandler")]
public virtual Android.Media.Image? AcquireNextImage();
[<Android.Runtime.Register("acquireNextImage", "()Landroid/media/Image;", "GetAcquireNextImageHandler")>]
abstract member AcquireNextImage : unit -> Android.Media.Image
override this.AcquireNextImage : unit -> Android.Media.Image

Gibt zurück

ein neuer Frame mit Bilddaten oder null wenn keine Bilddaten verfügbar sind.

Attribute

Ausnahmen

wenn maxImages Bilder zurzeit abgerufen werden

Hinweise

Rufen Sie das nächste Bild aus der ImageReader-Warteschlange ab. Gibt zurück null , wenn kein neues Bild verfügbar ist.

Warnung: Erwägen Sie stattdessen die Verwendung #acquireLatestImage() , da ältere Bilder automatisch freigegeben und langsamer ausgeführte Verarbeitungsroutinen den neuesten Frame aufholen können. Die Verwendung von #acquireNextImage wird für die Batch-/Hintergrundverarbeitung empfohlen. Die falsche Verwendung dieser Funktion kann dazu führen, dass Bilder mit einer immer höheren Verzögerung erscheinen, gefolgt von einem vollständigen Stand, in dem keine neuen Bilder erscheinen.

Dieser Vorgang schlägt fehl, indem es einen IllegalStateException Fehler auslöst, wenn maxImages er mit #acquireNextImage oder #acquireLatestImage. Insbesondere wird die zugrunde liegende Warteschlange durch eine Sequenz von #acquireNextImage anrufen oder #acquireLatestImage anrufe größer als #getMaxImages maxImages ohne Zwischenanrufe Image#close sein. Zu einem solchen Zeitpunkt wird ausgelöst, IllegalStateException bis weitere Bilder freigegeben Image#closewerden.

Java Dokumentation für android.media.ImageReader.acquireNextImage().

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

Weitere Informationen