CameraCharacteristics.AvailableSessionKeys Proprietà

Definizione

Spazio dei nomi:

Android.Hardware.Camera2

Assembly:

Mono.Android.dll

Restituisce un subset di #getAvailableCaptureRequestKeys chiavi che il dispositivo fotocamera può passare come parte dell'inizializzazione della sessione di acquisizione.

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>

Valore della proprietà

IList<Key>

Elenco di chiavi che possono essere passate durante l'inizializzazione della sessione di acquisizione. Nel caso in cui il dispositivo fotocamera non supporti tali chiavi, l'elenco può essere Null.

Attributi

RegisterAttribute

Commenti

Restituisce un subset di #getAvailableCaptureRequestKeys chiavi che il dispositivo fotocamera può passare come parte dell'inizializzazione della sessione di acquisizione.

Questo elenco include chiavi difficili da applicare per fotogramma e possono comportare ritardi imprevisti durante la modifica durante la durata della sessione di acquisizione. Gli esempi tipici includono parametri che richiedono una riconfigurazione hardware o una modifica interna della pipeline della fotocamera che richiede molto tempo. Per motivi di prestazioni, è consigliabile che i client passino i valori iniziali come parte di SessionConfiguration#setSessionParameters. Una volta abilitata la sessione di acquisizione della fotocamera, è consigliabile evitare di modificarle dai valori iniziali impostati in SessionConfiguration#setSessionParameters . Il controllo sui parametri di sessione può comunque essere esercitato nelle richieste di acquisizione, ma i client devono essere consapevoli e prevedere ritardi durante l'applicazione. Uno scenario di utilizzo di esempio potrebbe essere simile al seguente:

<ul><li>Il client della fotocamera inizia eseguendo una query sull'elenco di chiavi dei parametri di sessione tramite android.hardware.camera2.CameraCharacteristics#getAvailableSessionKeys .</li><li>Prima di attivare la sequenza di creazione della sessione di acquisizione, è necessario creare una richiesta di acquisizione usando CameraDevice#createCaptureRequest un modello appropriato corrispondente al caso d'uso specifico.</li><li>Il client deve esaminare l'elenco dei parametri di sessione e verificare se alcune delle chiavi elencate corrispondono ai parametri che intende modificare come parte della prima richiesta di acquisizione.</li><li>Se non esiste una corrispondenza di questo tipo, la richiesta di acquisizione può essere passata a SessionConfiguration#setSessionParameters .</li><li>Se esistono corrispondenze, il client deve aggiornare i rispettivi valori e passare la richiesta a SessionConfiguration#setSessionParameters .</li><li>Dopo che l'inizializzazione della sessione di acquisizione completa l'elenco di chiavi dei parametri di sessione può continuare a fungere da riferimento durante la registrazione o l'aggiornamento di ulteriori richieste. Come accennato in precedenza, è consigliabile evitare ulteriori modifiche ai parametri di sessione, se gli aggiornamenti sono necessari, tuttavia i client potrebbero aspettarsi un ritardo o un errore durante l'opzione del parametro.</li></ul>

L'elenco restituito non è modificabile, pertanto qualsiasi tentativo di modifica genera un'eccezione UnsupportedOperationException.

Ogni chiave viene elencata una sola volta nell'elenco. L'ordine delle chiavi non è definito.

Documentazione java per android.hardware.camera2.CameraCharacteristics.getAvailableSessionKeys().

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.