CameraCharacteristics.AvailableSessionKeys Eigenschaft

Definition

Namespace:

Android.Hardware.Camera2

Assembly:

Mono.Android.dll

Gibt eine Teilmenge von #getAvailableCaptureRequestKeys Schlüsseln zurück, die das Kameragerät als Teil der Aufnahmesitzungsinitialisierung übergeben kann.

public System.Collections.Generic.IList<Android.Hardware.Camera2.CaptureRequest.Key>? AvailableSessionKeys { [Android.Runtime.Register("getAvailableSessionKeys", "()Ljava/util/List;", "", ApiSince=28)] get; }

[<get: Android.Runtime.Register("getAvailableSessionKeys", "()Ljava/util/List;", "", ApiSince=28)>]
member this.AvailableSessionKeys : System.Collections.Generic.IList<Android.Hardware.Camera2.CaptureRequest.Key>

Eigenschaftswert

IList<Key>

Liste der Schlüssel, die während der Initialisierung der Aufnahmesitzung übergeben werden können. Falls das Kameragerät solche Schlüssel nicht unterstützt, kann die Liste null sein.

Attribute

RegisterAttribute

Hinweise

Gibt eine Teilmenge von #getAvailableCaptureRequestKeys Schlüsseln zurück, die das Kameragerät als Teil der Aufnahmesitzungsinitialisierung übergeben kann.

Diese Liste enthält Schlüssel, die nur schwer pro Frame angewendet werden können und zu unerwarteten Verzögerungen führen können, wenn sie während der Lebensdauer der Aufnahmesitzung geändert werden. Typische Beispiele sind Parameter, die eine zeitaufwendige Hardware-Neukonfiguration oder interne Kamerapipelineänderung erfordern. Aus Leistungsgründen empfehlen wir Clients, ihre Anfangswerte als Teil von SessionConfiguration#setSessionParameters. Sobald die Kameraaufnahmesitzung aktiviert ist, empfiehlt es sich auch, sie von ihren anfangs festgelegten SessionConfiguration#setSessionParameters Werten zu vermeiden. Die Kontrolle über Sitzungsparameter kann weiterhin in Erfassungsanforderungen ausgeübt werden, clients sollten sich jedoch bewusst sein und Verzögerungen während ihrer Anwendung erwarten. Ein Beispiel für ein Verwendungsszenario könnte wie folgt aussehen:

<ul><li>Der Kameraclient beginnt mit der Abfrage der Sitzungsparameterschlüsselliste über android.hardware.camera2.CameraCharacteristics#getAvailableSessionKeys .</li li>><Vor dem Auslösen der Erstellungssequenz der Aufnahmesitzung muss eine Aufnahmeanforderung mithilfe CameraDevice#createCaptureRequest einer geeigneten Vorlage erstellt werden, die dem jeweiligen Anwendungsfall entspricht.</li Li><>Der Client sollte die Liste der Sitzungsparameter durchlaufen und überprüfen, ob einige der aufgelisteten Schlüssel mit den Parametern übereinstimmen, die sie als Teil der ersten Aufnahmeanforderung ändern möchten.</li li>><Wenn keine solche Übereinstimmung vorhanden ist, kann die Aufnahmeanforderung unverändert SessionConfiguration#setSessionParameters übergeben werden.</li li>><Wenn Übereinstimmungen vorhanden sind, sollte der Client die entsprechenden Werte aktualisieren und die Anforderung SessionConfiguration#setSessionParameters an übergeben.</li li><>Nach Abschluss der Initialisierung der Aufnahmesitzung kann die Schlüsselliste des Sitzungsparameters weiterhin als Referenz dienen, wenn weitere Anforderungen veröffentlicht oder aktualisiert werden. Wie bereits erwähnt, sollten weitere Änderungen an Sitzungsparametern idealerweise vermieden werden, wenn Updates erforderlich sind, jedoch können Clients während des Parameterwechsels eine Verzögerung/Glitch erwarten.</li></ul>

Die zurückgegebene Liste kann nicht geändert werden, sodass alle Versuche, sie zu ändern, einen UnsupportedOperationException.

Jeder Schlüssel wird nur einmal in der Liste aufgeführt. Die Reihenfolge der Schlüssel ist nicht definiert.

Java-Dokumentation für android.hardware.camera2.CameraCharacteristics.getAvailableSessionKeys().

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.