Freigeben über


OutputConfiguration.StreamUseCase Eigenschaft

Definition

Abrufen des aktuellen Datenstromanwendungsfalls – oder Festlegen des Stream-Anwendungsfalls für diese OutputConfiguration

public long StreamUseCase { [Android.Runtime.Register("getStreamUseCase", "()J", "", ApiSince=33)] get; [Android.Runtime.Register("setStreamUseCase", "(J)V", "", ApiSince=33)] set; }
[<get: Android.Runtime.Register("getStreamUseCase", "()J", "", ApiSince=33)>]
[<set: Android.Runtime.Register("setStreamUseCase", "(J)V", "", ApiSince=33)>]
member this.StreamUseCase : int64 with get, set

Eigenschaftswert

der aktuell festgelegte Datenstromanwendungsfall

Attribute

Hinweise

Dokumentation zum Property Getter:

Abrufen des aktuellen Datenstromanwendungsfalls

Wenn kein #setStreamUseCase erster Aufruf erfolgt, gibt diese Funktion zurück CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES_DEFAULT DEFAULT.

Java-Dokumentation für android.hardware.camera2.params.OutputConfiguration.getStreamUseCase().

Dokumentation zum Eigenschaftensatzer:

Set stream use case for this OutputConfiguration

Der Stream-Anwendungsfall wird verwendet, um den Zweck des Datenstroms zu beschreiben, unabhängig davon, ob es sich um eine Livevorschau, eine stille Bildaufnahme, eine Videoaufzeichnung oder deren Kombinationen handelt. Dieses Kennzeichen ist nützlich für Szenarien, in denen das unmittelbare Consumerziel nicht ausreicht, um die Nutzung des Datenstroms anzugeben.

Der Hauptunterschied zwischen Stream-Anwendungsfall und Aufnahmeabsicht besteht darin, dass das Kameragerät die Optimierung von Kamerahardware- und Softwarepipelinen basierend auf Benutzerszenarien für jeden Datenstrom ermöglicht, während letzteres hauptsächlich ein Hinweis auf die Kamera ist, um eine optimale 3A-Strategie zu entscheiden, die für die gesamte Sitzung gilt. Das Kameragerät führt Konfigurationen aus, z. B. die Auswahl von Optimierungsparametern, das Auswählen des Kamerasensormodus und das Erstellen der Bildverarbeitungspipeline basierend auf den Anwendungsfällen der Datenströme. Erfassungsabsichten werden dann verwendet, um 3A-Verhaltensweisen wie das Anpassen der AE/AF-Konvergenzgeschwindigkeit zu optimieren, und Die Erfassungsabsichten können sich während der Lebensdauer einer Sitzung ändern. Bei einer Sitzung mit einem PREVIEW_VIDEO_STILL Anwendungsfalldatenstrom und einem STILL_CAPTURE Anwendungsfalldatenstroms können die Aufnahmeabsichten mit schneller 3A-Konvergenzgeschwindigkeit und Blitzmessung mit automatischer Steuerung für die Livevorschau, STILL_CAPTURE mit besten 3A-Parametern für die stille Fotoaufnahme oder VIDEO_RECORD mit langsamerer 3A-Konvergenzgeschwindigkeit für eine bessere Videowiedergabeerfahrung verwendet werden.

Die unterstützten Stream-Anwendungsfälle, die von einem Kameragerät unterstützt werden, können von android.hardware.camera2.CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASESabgefragt werden.

Die obligatorischen Datenstromkombinationen, die Datenstrom-Anwendungsfälle umfassen, finden Sie unter android.hardware.camera2.CameraDevice#createCaptureSession, sowie abgefragt über android.hardware.camera2.params.MandatoryStreamCombination. Die Anwendung wird dringend empfohlen, eine der garantierten Datenstromkombinationen auszuwählen, in denen die Anwendungsfälle aller Datenströme auf Nicht-STANDARDWERTe festgelegt sind. Wenn die Anwendung eine Datenstromkombination auswähnt, die nicht in der obligatorischen Liste enthalten ist, ignoriert das Kameragerät möglicherweise einige Anwendungsfallkennzeichnungen aufgrund von Hardwareeinschränkungen oder Implementierungsdetails.

Diese Funktion muss vor oder CameraDevice#createCaptureSessionByOutputConfigurations.CameraDevice#createCaptureSession Aufrufen dieser Funktion nach CameraDevice#createCaptureSession oder CameraDevice#createCaptureSessionByOutputConfigurations hat keine Auswirkungen auf die Kamerasitzung.

Java-Dokumentation für android.hardware.camera2.params.OutputConfiguration.setStreamUseCase(long).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: