CameraDevice.CreateExtensionSession(ExtensionSessionConfiguration) Methode

[Android.Runtime.Register("createExtensionSession", "(Landroid/hardware/camera2/params/ExtensionSessionConfiguration;)V", "GetCreateExtensionSession_Landroid_hardware_camera2_params_ExtensionSessionConfiguration_Handler", ApiSince=31)]
public virtual void CreateExtensionSession(Android.Hardware.Camera2.Params.ExtensionSessionConfiguration extensionConfiguration);

[<Android.Runtime.Register("createExtensionSession", "(Landroid/hardware/camera2/params/ExtensionSessionConfiguration;)V", "GetCreateExtensionSession_Landroid_hardware_camera2_params_ExtensionSessionConfiguration_Handler", ApiSince=31)>]
abstract member CreateExtensionSession : Android.Hardware.Camera2.Params.ExtensionSessionConfiguration -> unit
override this.CreateExtensionSession : Android.Hardware.Camera2.Params.ExtensionSessionConfiguration -> unit

Parameter

Attribute

RegisterAttribute

Hinweise

Initialisieren Einer bestimmten gerätespezifischen Erweiterung erweiterten Kameraaufnahmesitzung.

Erweiterungssitzungen können verwendet werden, um gerätespezifische Betriebsmodi wie CameraExtensionCharacteristics#EXTENSION_NIGHT oder CameraExtensionCharacteristics#EXTENSION_HDR. Diese Modi sind weniger flexibel als die vollständige Kamera-API, ermöglichen jedoch den Zugriff auf komplexere Verarbeitungsalgorithmen, die Multiframe-Bursts erfassen können, um einzelne Ausgabebilder zu generieren. So fragen Sie nach verfügbaren Erweiterungen auf diesem Geräteaufruf ab CameraExtensionCharacteristics#getSupportedExtensions().

Diese Methode löst auch das Einrichten der internen Verarbeitungspipeline für erweiterungsweitere Vorschau und die Aufnahme mehrerer Frames aus.

Wenn beim Aufrufen dieser Methode bereits eine vorherige CameraCaptureSession vorhanden ist, kann die vorherige Sitzung keine neuen Aufnahmeanforderungen mehr annehmen und geschlossen werden. Alle in Bearbeitung ausgeführten Erfassungsanforderungen an die vorherige Sitzung werden abgeschlossen, bevor sie geschlossen wird.

Die CameraExtensionSession wird aktiv, bis der Client entweder CameraExtensionSession.close() aufruft oder eine neue Kameraaufnahmesitzung erstellt. In beiden Fällen werden alle internen Ressourcen freigegeben, fortlaufende wiederholte Anforderungen beendet und alle ausstehenden Mehrframe-Aufnahmeanforderungen geleert.

Beachten Sie, dass die CameraExtensionSession derzeit höchstens in Multiframe-Aufnahmeoberflächenformaten unterstützt wird: ImageFormat.JPEG werden von allen Erweiterungen unterstützt, und ImageFormat.YUV_420_888 möglicherweise oder nicht unterstützt werden. Clients müssen die Unterstützung des Multiframe-Aufnahmeformats mithilfe von CameraExtensionCharacteristics#getExtensionSupportedSizes(int, int)Clients abfragen. Bei wiederholten Anforderungen unterstützt CameraExtensionSession nur android.graphics.SurfaceTexture als Ausgabe. Clients können die unterstützte Auflösung für die Ausgabe der wiederholten Anforderung mithilfe von CameraExtensionCharacteristics#getExtensionSupportedSizes(int, Class) getExtensionSupportedSizes(..., Class)Abfragen abfragen.

Die Initialisierung erwartet mindestens eine gültige Ausgabeoberfläche für wiederholte oder eine gültige Ausgabe für hochwertige einzelne Anforderungen, die im Ausgabeargument des Erweiterungskonfigurationsarguments registriert sind. Die Initialisierung akzeptiert maximal zwei gültige Ausgabeoberflächen, eine für die Wiederholung und die andere für einzelne Anforderungen. Zusätzliche nicht unterstützte Oberflächen, die an ExtensionSessionConfiguration übergeben werden, führen zu einem IllegalArgumentException Auslösen.

Java Dokumentation für android.hardware.camera2.CameraDevice.createExtensionSession(android.hardware.camera2.params.ExtensionSessionConfiguration).

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.