CaptureRequest.ControlSettingsOverride Eigenschaft

[Android.Runtime.Register("CONTROL_SETTINGS_OVERRIDE", ApiSince=34)]
public static Android.Hardware.Camera2.CaptureRequest.Key ControlSettingsOverride { get; }

[<Android.Runtime.Register("CONTROL_SETTINGS_OVERRIDE", ApiSince=34)>]
static member ControlSettingsOverride : Android.Hardware.Camera2.CaptureRequest.Key

Eigenschaftswert

Die gewünschten CaptureRequest-Einstellungen überschreiben, mit denen bestimmte Schlüssel früher angewendet werden, sodass sie früher wirksam werden können.

Attribute

RegisterAttribute

Hinweise

Die gewünschten CaptureRequest-Einstellungen überschreiben, mit denen bestimmte Schlüssel früher angewendet werden, sodass sie früher wirksam werden können.

Es gibt einige CaptureRequest-Schlüssel, die früher als andere angewendet werden können, wenn Steuerelemente in einer CaptureRequest nicht gleichzeitig wirksam werden müssen. Ein solches Beispiel ist Zoom. Zoom kann zu einem späteren Zeitpunkt der Kamerapipeline angewendet werden. Sobald das Kameragerät die CaptureRequest empfängt, kann er den angeforderten Zoomwert auf eine frühere Anforderung anwenden, die sich bereits in der Pipeline befindet, wodurch die Zoomlatenz verbessert wird.

Der Wert dieses Schlüssels im Aufnahmeergebnis gibt an, ob die Steuerelemente für diese Erfassung von einer neueren Anforderung "von" überschrieben werden. Wenn eine Aufnahmeanforderung die Einstellungsüberschreibung aktiviert, enthält das Aufnahmeergebnis einer früheren Anforderung den Schlüsselwert zoom. Wenn eine Aufnahmeanforderung dagegen Einstellungen außer Kraft gesetzt hat, aber alle neueren Anforderungen deaktiviert haben, ist der Wert des Schlüssels im Aufnahmeergebnis deaktiviert, da diese Erfassung nicht von einer neueren Erfassung überschrieben wird. In den beiden folgenden Beispielen veranschaulichen die Spalten "capture results" die settingsOverride-Werte in verschiedenen Szenarien.

Camera session created
Request 1 (zoom=1.0x, override=ZOOM) ->
Request 2 (zoom=1.2x, override=ZOOM) ->
Request 3 (zoom=1.4x, override=ZOOM) ->  Result 1 (zoom=1.2x, override=ZOOM)
Request 4 (zoom=1.6x, override=ZOOM) ->  Result 2 (zoom=1.4x, override=ZOOM)
Request 5 (zoom=1.8x, override=ZOOM) ->  Result 3 (zoom=1.6x, override=ZOOM)
                                     ->  Result 4 (zoom=1.8x, override=ZOOM)
                                     ->  Result 5 (zoom=1.8x, override=OFF)

Die Anwendung kann einstellungen außer Kraft setzen und den Zoom normal verwenden. Das Beispiel zeigt, dass die späteren Zoomwerte (1,2x, 1,4x, 1,6x und 1,8x) die Zoomwerte (1,0x, 1,2x, 1,4x und 1,8x) von früheren Anforderungen (#1, #2, #3 und #4) überschreiben.

Die Anwendung muss sicherstellen, dass die Außerkraftsetzung der Einstellungen die Benutzerreise nicht beeinträchtigt, die gleichzeitige Anwendung aller Steuerelemente in CaptureRequest für die angeforderten Ausgabeziele erfordert. Wenn die Anwendung beispielsweise eine stille Aufnahme mit CameraCaptureSession#capture verwendet, und die wiederholte Anforderung legt sofort einen anderen Zoomwert mithilfe der Außerkraftsetzung fest, könnte die Inflight-Aufnahme ihren Zoomwert unerwartet überschrieben haben.

Daher wird die Anwendung dringend empfohlen, settingsOverride beim Aufnehmen von Still-/Burst-Aufnahmen zu deaktivieren und wieder zu aktivieren, wenn nur wiederholte Sucheranforderungen vorhanden sind und keine Still-/Platzaufnahmen für Inflights vorhanden sind.

Request 1 (zoom=1.0x, override=OFF)
Request 2 (zoom=1.2x, override=OFF)
Request 3 (zoom=1.4x, override=ZOOM)  -> Result 1 (zoom=1.0x, override=OFF)
Request 4 (zoom=1.6x, override=ZOOM)  -> Result 2 (zoom=1.4x, override=ZOOM)
Request 5 (zoom=1.8x, override=OFF)   -> Result 3 (zoom=1.6x, override=ZOOM)
                                      -> Result 4 (zoom=1.6x, override=OFF)
                                      -> Result 5 (zoom=1.8x, override=OFF)

In diesem Beispiel wird gezeigt, dass die Einstellung der Anwendung "Rampen in" außer Kraft setzt, indem das Steuerelement auf ZOOM festgelegt wird. In dem Beispiel aktiviert Anforderung Nr. 3 die Außerkraftsetzung von Zoomeinstellungen. Da das Kameragerät das Anwenden des Zooms um 1 Frame beschleunigen kann, hat die Ausgabe der Anforderung Nr. 2 1,4x Zoom, den in Anforderung #3 angegebenen Wert; Die Anwendung setzt einstellungen außer Kraft, indem das Steuerelement auf "AUS" festgelegt wird. In dem Beispiel ändert anforderung #5 die Außerkraftsetzung in OFF. Da der Zoom der Anforderung #4 in Ergebnis 3 wirksam wird, bleibt der Zoom von Ergebnis #4 unverändert, bis der neue Wert in Ergebnis #5 wirksam wird.

Mögliche Werte: AUS; ZOOM

Verfügbare Werte für dieses Gerät: android.control.availableSettingsOverrides

Optional – Der Wert für diesen Schlüssel kann auf einigen Geräten NULL sein.

Android-Referenz für android.hardware.camera2.CaptureRequest.CONTROL_SETTINGS_OVERRIDE.

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.